Home » Blog » Asterisk/Vicidial » How To Install Asterisk PBX 18 LTS on CentOS 7

How To Install Asterisk PBX 18 LTS on CentOS 7

How To Install Asterisk PBX 18 LTS on CentOS 7

How To Install Asterisk PBX 18 LTS on CentOS 7. Asterisk, first and foremost, is a Private Branch Exchange. A PBX is a piece of equipment that handles telephone switching owned by a private business, rather than a telephone company. A PBX can be thought of as a private phone switchboard, connecting to one or more telephones on one side and usually connecting to one or more telephone lines on the other.

Asterisk is a complete PBX. It implements all the major features of most commercially available PBXes. It also implements, for free, features that often cost a lot in a commercial installation: Conference calling, Direct Inward System Access, Call Parking, and Call Queues, just to name a few.

The basic features provided by Asterisk are:

  • Caller ID
  • Blacklisting (Block callers by Caller ID)
  • Call Waiting
  • Call Transfer
  • Call Conferencing
  • Conference Center/Bridging
  • Do‐Not‐Disturb
  • Call Forwarding
  • Call Parking
  • Call Detail Reporting
  • Dial by Name Directory
  • Interactive Voice Response (Auto Attendant)
  • Time Condition Call Routing
  • Call Queuing
  • Call Back
  • Hold Music/Recordings (MP3)
  • Application Integration
  • Extended Call Reporting
  • DISA (Direct Inward System Access)
  • Dictation
  • Follow Me
  • Paging/Intercom
  • Ring Groups
  • Graphical Call Manager
  • Day/Night Controls
  • Among others. So let’s get started.

Step 1 – Set Server Hostname

You can set hostname and timezone before doing any installation. Use below commands.

sudo timedatectl  list-timezones
sudo timedatectl  set-timezone Africa/Nairobi

To set hostname type:

sudo hostnamectl set-hostname pbx-01.example.com

In case your CentOS server has wrong keymaps. You can fix them.

$ localectl 
   System Locale: LANG=en_US.UTF-8
       VC Keymap: us
      X11 Layout: us
$ localectl list-keymaps

To set keymap to us:

sudo localectl set-keymap us

You can set the system language to English by typing following commands on your terminal as root.

sudo localectl set-locale LANG=en_US.UTF-8

Step 2 – Update System and Install dependencies

First, do a system update

sudo yum -y update
sudo yum -y install "@Development Tools"

Reboot after system upgrade

sudo reboot

Install other dependencies required to build and run Asterisk 18 LTS on CentOS 7:

sudo yum -y install lynx mariadb-server mariadb php php-mysql \
  php-mbstring tftp-server httpd ncurses-devel sendmail sendmail-cf \
  sox newt-devel libxml2-devel libtiff-devel audiofile-devel gtk2-devel \
  subversion kernel-devel git php-process crontabs cronie cronie-anacron \
  wget vim php-xml uuid-devel sqlite-devel net-tools gnutls-devel php-pear \
  autoconf bzip2 libedit-devel

Install other missing dependencies, not in the previous step.

sudo yum -y install gcc gcc-c++ php-xml php php-mysql php-pear php-mbstring mariadb-devel mariadb-server mariadb sqlite-devel lynx bison psmisc tftp-server httpd make ncurses-devel libtermcap-devel sendmail sendmail-cf caching-nameserver sox newt-devel libxml2-devel libtiff-devel audiofile-devel gtk2-devel uuid-devel libtool libuuid-devel subversion kernel-devel kernel-devel-$(uname -r) git subversion kernel-devel php-process crontabs cronie cronie-anacron wget vim

Setup and configure mariadb database, setting the password as well.

systemctl start mariadb
systemctl enable mariadb

Now set the password by running the command below.

sudo mysql_secure_installation

Just press enter if you don’t already have a password set for mysql. Agree to remove the test database and disallow remote login.

Step 3 – Install Jasson C Library

Installing Jansson which is a C library for encoding, decoding and manipulating JSON data. Let’s download, unpack and compile it using the below command.

sudo su -
cd /usr/src
mkdir asterisk-18 && cd asterisk-18
git clone https://github.com/akheron/jansson.git
cd jansson
autoreconf  -i
./configure --prefix=/usr/
make && make install

Install Legacy Pear requirements

pear install Console_Getopt

Step 4 – Install Asterisk 18 LTS on CentOS 7

Navigate to /usr/src/asterisk-18 directory and install download Asterisk 18 LTS on CentOS 7

cd  /usr/src/asterisk-18
wget http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-complete-current.tar.gz
wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-current.tar.gz
wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-18-current.tar.gz
git clone https://github.com/pjsip/pjproject.git

Compile and install DAHDI if you are connecting to PSTN. This is OPTIONAL, install if you’ll connect to PSTN.

cd  /usr/src/asterisk-18
tar xvfz dahdi-linux-complete-current.tar.gz
tar xvfz libpri-current.tar.gz
rm -f dahdi-linux-complete-current.tar.gz libpri-current.tar.gz
cd dahdi-linux-complete-*/
make all
make install
make config
cd ..
cd libpri-*/
make install

Compile and install pjproject

cd  /usr/src/asterisk-18
cd pjproject
CFLAGS='-DPJ_HAS_IPV6=1' ./configure --prefix=/usr \
  --enable-shared --disable-sound \
  --disable-resample --disable-video \
  --disable-opencore-amr --libdir=/usr/lib64
make dep
make all
make install

Compile and install Asterisk

cd /usr/src/asterisk-18
tar xvfz asterisk-18-current.tar.gz
cd asterisk-*
./configure --libdir=/usr/lib64

Setup menu options by running the following command

make menuselect

On Add-ons select chan_ooh323 and format_mp3  as shown below


On Core Sound Packages, select the formats of Audio packets like below


On  Music On Hold, option select the following modules as shown in the picture below


On Extra Sound Packages select as shown below:

Now run the following command to download the mp3 decoder library into the source tree.

cd /usr/src/asterisk-18/asterisk-*

Do installation of selected modules

cd /usr/src/asterisk-18/asterisk-*/
make install
make samples
make config

Step 5 – Configure Asterisk 18 LTS on CentOS 7

Create separate user and group to run asterisk services

useradd -m asterisk
chown asterisk.asterisk /var/run/asterisk
chown -R asterisk.asterisk /etc/asterisk
chown -R asterisk.asterisk /var/{lib,log,spool}/asterisk 
chown -R asterisk.asterisk /usr/lib64/asterisk

Make systemctl start asterisk by copying init script to init.d dir.

cd /usr/src/asterisk-18/asterisk-*
cp contrib/init.d/rc.redhat.asterisk  /etc/init.d/asterisk
chmod 755 /etc/init.d/asterisk

Locate asterisk by

$ which asterisk

Then open the file /etc/init.d/asterisk by

sudo vim /etc/init.d/asterisk

Replace AST_SBIN=, with your location of asterisk binary, for my case it’s /sbin/. See below image.

Disable SELinux

sed -i 's/(^SELINUX=).*/SELINUX=disabled/' /etc/selinux/config

Setup Asterisk Database

[root@asterisk-cloud ~]# mysql -u root -p
create user 'asterisk'@'localhost' identified by 'password';
create database cdrdb;
create database asterisk;
GRANT ALL PRIVILEGES ON asterisk.* TO asterisk@localhost IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON cdrdb.* TO asterisk@localhost IDENTIFIED BY 'password';
flush privileges; 

Make all asterisk PBX ports accessible by adding the following rules

firewall-cmd --zone=public --add-port=5060/udp --permanent
firewall-cmd --zone=public --add-port=5060/tcp --permanent
firewall-cmd --zone=public --add-port=5061/udp --permanent
firewall-cmd --zone=public --add-port=5061/tcp --permanent
firewall-cmd --zone=public --add-port=4569/udp --permanent
firewall-cmd --zone=public --add-port=5038/tcp --permanent 
firewall-cmd --zone=public --add-port=10000-20000/udp --permanent

Commit changes

firewall-cmd --reload

Confirm that the rules are added.

[root@asterisk-cloud ~]# firewall-cmd --zone=public --list-all 
public (default, active)
  interfaces: eth0
  services: dhcpv6-client ssh
  ports: 5061/tcp 4569/udp 5060/tcp 10000-20000/udp 5061/udp 5060/udp 5038/tcp
  masquerade: no
  rich rules:

Restart asterisk server

systemctl restart asterisk

Check if running

sudo systemctl status asterisk

That’s it.

Scroll to Top