Just launched: Multi-language voice support for global campaigns.
Self-Hosted Deployment

Run Telentir on Your Own Infrastructure

Deploy Telentir’s fully featured AI Voice Agents and call-automation platform on-premises or within your private cloud. Retain complete control over your data, security, and compliance while leveraging all of Telentir’s capabilities.

View Installation Guide

Why Choose Self-Hosted?

Data Sovereignty

All call recordings, transcripts, and configuration data remain within your own environment—never leaving your firewalls. Ideal for industries with strict data regulations.

Custom Security Controls

Integrate with your existing identity management, network policies, and encryption standards. Apply role-based access, VPN restrictions, or on-prem firewall rules as required.

Flexible Infrastructure

Choose your operating system (Linux distributions supported), hardware specs, and cloud provider. Scale resources as your call volume grows—whether on bare metal, VMs, or Kubernetes clusters.

Full Customization

Modify dialing logic, integrate with niche CRMs, or add specialized NLP modules. Access the same APIs and configuration files you rely on in our hosted environment.

Compliance & Auditing

Generate audit logs, record retention policies, and maintain compliance with GDPR, HIPAA, or other regional regulations. Control update schedules and patch cycles on your timeline.

Offline & Air-Gapped

Deploy Telentir in environments without internet access. Use our installer to set up AI Voice Agents and databases entirely offline, then sync transcripts when a secure channel becomes available.

System Requirements

Telentir can run on minimal infrastructure for evaluation or testing. Below are the absolute minimum requirements. For production use or high call volume, scale resources accordingly.

  • Operating System: Ubuntu 20.04+ (64-bit), Debian 10+, or similar Linux distribution.
  • CPU: Dual-core x86_64 processor (e.g., Intel i3 or equivalent) at 2.0GHz or higher.
  • Memory: 2 GB RAM minimum (4 GB+ recommended).
  • Storage: 2 GB SSD minimum for basic installation. More space required if storing logs or call recordings.
  • Network: Stable internet with 10 Mbps upload/download. Public IP or STUN/TURN support required.
  • Database: PostgreSQL 12+ (local or remote). 1 GB RAM allocation minimum.
  • Dependencies: Docker Engine 20.10+, Node.js 16+. Kubernetes is optional for scaling.
  • Firewall & Ports: TCP 443 (HTTPS), TCP 5432 (PostgreSQL), and relevant UDP ports for SIP/WebRTC.

High-Level Installation Workflow

1. Provision & Prep Infrastructure

Spin up a clean Linux server (bare metal, VM, or container). Update packages, configure hostname, and ensure SSH access. Set up a firewall (iptables/ufw) to allow only necessary ports.

```bash
sudo apt update && sudo apt upgrade -y
sudo ufw allow OpenSSH
sudo ufw allow 443/tcp
sudo ufw enable
```

2. Install Dependencies

Install Docker Engine, Docker Compose (if using compose), and Git. Ensure PostgreSQL is installed on either the same server or a separate database host.

```bash
# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Install docker-compose plugin
sudo apt-get install -y docker-compose-plugin
# Install Git
sudo apt-get install -y git
```

3. Clone & Configure Telentir Repository

Clone the Telentir self-hosted repo, copy the sample environment file, and update values for database credentials, API keys, and encryption secrets.

bash
# Pull and run Telentir from the Docker registry
docker pull telentir/self-hosted:latest

# Set up your environment file
curl -O https://telentir.com/env/.env.example
cp .env.example .env
nano .env  # Edit DB_HOST, DB_USER, DB_PASS, TELEPHONY_PROVIDER, ENCRYPTION_KEY, etc.

4. Launch Containers & Initialize Database

Use Docker Compose to build and start all Telentir services. The first run will automatically apply migrations and seed required tables.

```bash
# From the self-hosted directory
docker compose up -d --build
# Check logs to confirm successful startup
docker compose logs -f
```

5. Configure Telephony & Webhooks

Point your SIP trunk or telephony provider to Telentir’s SIP gateway (UDP/TCP ports). Configure webhook endpoints in your telco dashboard to forward incoming call events to Telentir’s REST endpoints.

```text
SIP Server: your.server.ip or FQDN
SIP Protocol: UDP/TCP 5060
Webhook (call events): https://your.server.domain/api/telephony/webhook
```

6. Access Admin UI & Create First Campaign

Open your browser to https://your.server.domain. Log in with the default admin credentials, then update your password. Navigate to “Campaigns” to set up dialing lists, conversational pathways, and AI-agent personas.

```text
URL: https://your.server.domain
Username: admin@example.com
Password: changeme123
```

Need Help?

If you run into any issues during installation or configuration, our documentation and support team are here to help. Explore our resources: