Installation on Docker

Docker has become a popular way of running services in the cloud. Vodia has prepared a docker image that can be deployed in seconds and provides you a running instance of the Vodia PBX. In a nutshell, all you need to do is:

docker pull vodia/pbx
docker run -d --net=host vodia/pbx

After the service is running, you need to go through the normal PBX installation process which is independent from the operating system. This includes accepting the license agreement, entering the license key, setting up domains, SIP trunks, DNS entries, uploading X.509 certificates and so on.


Before you can run the Vodia PBX in the Docker environment, you obviously need to install Docker. There is plenty of documentation available for this, we don't have to repeat that information here.

As with all PBX services, running the PBX process is a time critical task that gets best done running on a physical host (bare metal). You need to make sure that the network connectivity allows running a reliable service, including enough bandwidth and failover mechanisms e.g. if a switch should fail or require a software update.

Network Connectivity

Because the PBX needs to expose a large range of ports, it is easier to expose all ports of the host to the container. Especially the large range of RTP ports can be a challenge if they need to be expored one-by-one, which slows down the host significantly. This is done with the --net=host option when you run the image.

Automatic Start

The image is based on Debian. The image does not run a service like this is done on a typical Linux Vodia PBX installation. Instead it just runs the PBX in an endless loop. That means if you choose to restart the PBX from the web interface, you should terminate the process, but not the whole server.