SIP server | LiveKit docs

Overview

LiveKit SIP server allows you to make and receive phone calls using your LiveKit deployment. It's a self-hosted solution that allows you to deploy a SIP server on your own infrastructure.

Caution

Both SIP signaling port (5060) and media port range (10000-20000) must be accessible from the Internet. See Firewall configuration for details.

Docker Compose

The easiest way to run SIP Server is by using Docker Compose:

wget https://raw.githubusercontent.com/livekit/sip/main/docker-compose.yaml
docker compose up

This starts a local LiveKit server and SIP server connected to Redis.

Running natively

You can also run SIP server natively without Docker.

Install SIP server by following the Running locally instructions.

Create the config.yaml file with the following contents:

api_key: <your-api-key>
api_secret: <your-api-secret>
ws_url: ws://localhost:7880
redis:
  address: localhost:6379
sip_port: 5060
rtp_port: 10000-20000
use_external_ip: true
logging:
  level: debug

Run the SIP server:
```
livekit-sip --config=config.yaml
```
Determine your SIP URI. Once your SIP server is running, you would have to determine the public IP address of the machine. Then your SIP URI should be in the format of <public-ip-address>:5060.