You can support us by downloading this article as PDF from the Link below. Download the guide as PDF

PBX is short fro Private Branch Exchange. It is a private telephone system used within an organization and customized to suit the needs of a particular organization. PBX users from an organization can communicate internally amongst themselves and also externally with the outside world. External communication is facilitated by channels such as VoIP (Voice over IP), ISDN (Integrated Services Digital Network) or analog.

The advantages of using PBX phone systems are that you can get more phones than the physical lines, free calls between users and massive features such as call queues, Digital receptionist, call forwarding, voicemail and call recording among others. Some examples of PBX phone systems include FreeSwitch, 3cx, Elastix, FreePBX and Asterisk.

In this guide, we are going to look at how to install FreeSwitch PBX on Ubuntu 20.04/18.04

What is FreeSwitch PBX?

FreeSwitch is a free open-source communication platform. It enables real time communication, video and Voice over IP and WebRTC. It runs on Windows, MacOS, Linux and FreeBSD. It is used in building a PBX system with functionalities such as web conferencing with chats and screen sharing, IVR, Session Border Controller, wholesale least-cost routing among others.

What are some of the features of FreeSwitch PBX system?

  • Runs on Windows, Linux and FreeBSD
  • IVR API
  • WebRTC support
  • Call recording (In Stereo caller/callee left/right)
  • High Performance Multi-Threaded Core engine
  • Parallel Hunting
  • Serial Hunting
  • Automated Attendant
  • Basic IP/PBX features
  • Custom Ring Back Tones (Early Media)

Install FreeSwitch PBX on Ubuntu 20.04/18.04

First update your system packages

sudo apt -y update

Next, install dependencies required for running FreeSwitch PBX on Ubuntu 20.04/18.04

sudo apt install -y git subversion build-essential autoconf automake libtool libncurses5 libncurses5-dev make libjpeg-dev libtool libtool-bin libsqlite3-dev libpcre3-dev libspeexdsp-dev libldns-dev libedit-dev yasm liblua5.2-dev libopus-dev cmake

The following packages are optional but we can install them.

sudo apt install -y libcurl4-openssl-dev libexpat1-dev libgnutls28-dev libtiff5-dev libx11-dev unixodbc-dev libssl-dev python-dev zlib1g-dev libasound2-dev libogg-dev libvorbis-dev libperl-dev libgdbm-dev libdb-dev uuid-dev libsndfile1-dev

Install libks and signal wire

sudo apt install -y cmake
cd /usr/src
sudo git clone https://github.com/signalwire/libks.git
cd libks
sudo cmake .
sudo make
sudo make install

cd /usr/src
git clone https://github.com/signalwire/signalwire-c.git
cd signalwire-c
sudo cmake .
sudo make
sudo make install

Next, get the latest FreeSwitch version from releases page using wget:

cd /usr/src
sudo wget https://files.freeswitch.org/freeswitch-releases/freeswitch-1.10.3.-release.zip
sudo apt -y install unzip
sudo unzip freeswitch-1.10.3.-release.zip
cd freeswitch-1.10.3.-release/

Note that if you do not have unzip installed, install it by running apt -y install unzip

sudo apt -y install unzip

Now run standard installation process

sudo ./configure -C
sudo make

If you encounter errors during compilation, you can comment out any module throwing the error or install the missing dependencies. In my case, I had initially commented out languages/mod_lua and applications/mod_signalwire but you can comment out more depending on the errors you get. After which you restart the compilation as shown below:

sudo ./configure && sudo make clean && sudo make

For a successful compilation, you will see an output as below:

Next, install freeswitch:

sudo make install

Output

Now compile sounds

sudo make all cd-sounds-install cd-moh-install

Create simlinks to use services easily.

sudo ln -s /usr/local/freeswitch/bin/freeswitch /usr/bin/
sudo ln -s /usr/local/freeswitch/bin/fs_cli /usr/bin

Add new group and user with less privileges to run FreeSWITCH service.

cd /usr/local
sudo groupadd freeswitch
sudo adduser --disabled-password  --quiet --system --home /usr/local/freeswitch --gecos "FreeSWITCH Voice Platform" --ingroup freeswitch freeswitch
sudo chown -R freeswitch:freeswitch /usr/local/freeswitch/
sudo chmod -R ug=rwX,o= /usr/local/freeswitch/
sudo chmod -R u=rwx,g=rx /usr/local/freeswitch/bin/

We need to add FreeSwitch as a systemd unit file. Open new file /etc/systemd/system/freeswitch.service using your favorite editor paste the below content:

sudo vim /etc/systemd/system/freeswitch.service

Paste the following content

[Unit]
Description=freeswitch
Wants=network-online.target
Requires=syslog.socket network.target local-fs.target
After=syslog.socket network.target network-online.target local-fs.target

[Service]
Type=forking
Environment="DAEMON_OPTS=-nonat"
EnvironmentFile=-/etc/default/freeswitch
ExecStartPre=/bin/chown -R freeswitch:freeswitch /usr/local/freeswitch
ExecStart=/usr/bin/freeswitch -u freeswitch -g freeswitch -ncwait $DAEMON_OPTS
TimeoutSec=45s
Restart=always
RestartSec=90
StartLimitInterval=0
StartLimitBurst=6

User=root
Group=daemon
LimitCORE=infinity
LimitNOFILE=100000
LimitNPROC=60000
LimitSTACK=250000
LimitRTPRIO=infinity
LimitRTTIME=infinity
IOSchedulingClass=realtime
IOSchedulingPriority=2
CPUSchedulingPolicy=rr
CPUSchedulingPriority=89
UMask=0007
NoNewPrivileges=false

[Install]
WantedBy=multi-user.target

Start FreeSwitch service and enable it on boot

sudo chmod ugo+x freeswitch.service
sudo systemctl start freeswitch.service
sudo systemctl enable freeswitch.service

Now check status of FreeSWITCH service

sudo systemctl status freeswitch.service

If freeswitch is properly installed and running the output should be as shown

Now you can connect to FreeSWITCH using client as below

# fs_cli -r

You will see an output as below:

PBX related courses.

$16.58
$47.36
in stock
Udemy.com
$15.40
$47.36
in stock
Udemy.com

This has been a guide on how to install FreeSwitch PBX on Ubuntu 20.04/18.04. Check more guides below!

You can support us by downloading this article as PDF from the Link below. Download the guide as PDF