Since containerization and microservices seems to be the way to got in future software production, I’ve decided to take a look at our current sipxcom/uniteme platform and find a way to implement this concept with no core code change.

Dockerization of one service from our enterprise platform without touching the code will require to move that service from init.d  to a container running over docker daemon according to the next figure:

Dockerizing Freeswitch

Next hurdle encountered was that “Docker requires a 64-bit OS and version 3.10 or higher of the Linux kernel.” per which is not implemented in our current Centos 6.X base version we are using for Uniteme deployments.


This will be one of the things our developers will take into consideration when they will develop a fully containerized solution, but since my Proof of Concept was focused just on containerization of just one element (Freeswitch) I’ve decided to use unsupported version of docker-engine 1.7.1 publised here

To add this repository to your currently running uniteme machine you will need to run these commands:

<em>tee /etc/yum.repos.d/docker.repo &lt;&lt;-'EOF'
 name=Docker Repository

<em>yum -y install docker-engine</em>

<em>service docker start</em>


Next step will be to remove all freeswitch rpm’s from your Uniteme/SipXcom test machine with:

rpm -e $(rpm -qa 'freeswitch*') --nodeps


Now all that is needed to have a functional and running freeswitch container will be to execute following command:

docker run -d --name="FSContainer" -v /usr/share:/usr/share -v /var/:/var/ -v /etc/sipxpbx:/etc/sipxpbx --net=host --privileged costache2mihai/dockerizedfreeswitch:minimalFS

-d option will run this container in detached mode (like a daemon)

–name will assign a name of your choice, in my case was FSContainer to be able to manipulate this container with eas

-v option will mount needed volumes to freeswitch container. You can find which are needed files /directories to be mounted by running ps -ef | grep freeswitch on a machine where freeswitch is running as a service

–net=host will allow freeswitch that is running inside the container to listen and execute operations directly on the host interface. You could restrict container access by just exposing certain ports that should be used, but for this PoC we just wanted to demonstrate the functionality of mediaservices in a container

–privileged will  increase container rights to be able to listen directly on host interface

costache2mihai/dockerizedfreeswitch:minimalFS  is the repository and the tag used by me to publish docker image that we are using in this PoC


Let’s have a look at the Dockerfile used to create docker image:

FROM centos:7

MAINTAINER Mihai &lt;;

RUN yum clean all &amp;&amp; yum install -y epel-release &amp;&amp; yum install -y freeswitch-config-vanilla freeswitch-lang-en freeswitch-sounds-en freeswitch-event-erlang-event &amp;&amp; yum clean all

CMD freeswitch -nonat -conf /etc/sipxpbx/freeswitch/conf -db /var/sipxdata/tmp/freeswitch -log /var/log/sipxpbx -run /var/run/sipxpbx -htdocs /etc/sipxpbx/freeswitch/conf/htdoc

We instruct docker to use a CentOS 7 base image.

We will try to keep this image at a minimum so we will only install one language for freeswitch and we will clean yum cache with yum clean all command. Important to note here is that we’ve used && to run all commands in just one step in order to avoid creation of unnecessary intermediary docker images. Instructions on how to install freeswitch on centos 7  can be found here:

Last line in our Dockerfile is the command/entrypoint we will like to be executed when this image will be used by the container. Freeswitch starting command was taken  with the above “ps -ef  | grep freeswitch” procedure from a running uniteme server and you can easily identify what files and folders are needed to be mounted by the docker run command.

In order for this dockerfile to become a docker image you will need to run docker build command locally or you can change/pull that Dockerfile, uploaded it to your git repository and use integrated build utility from docker hub.

In my case I have dockerfile uploaded here:

Next in my docker hub account under Create→ Automated Build I’ve selected my github account, next  one will need to point the build tool to the wanted repository, In this case Dockerized Freeswitch

Github dockerize freeswitch

The final step will be to click Create button and now we have also an automated build process on docker hub


More About the sipXcom Project:

From 2010 to 2015, sipXecs primary development contributions were provided by the development team at eZuce, Inc. The sipXcom open source communications project was established in January of 2015 from a fork in the sipXecs project by the development team at eZuce, Inc. With the creation of sipXcom, this team shifted its focus to contributing to the new project and no longer maintains sipXecs code nor participate in the SIPfoundry forums.

The experts who have helped to build sipXecs into the incredible product that it is will be found in the Google Groups ( and (