In this guide, we’ll cover the installation and configuration of 3CX on Ubuntu 18.04 Bionic Beaver Linux. This guide is a part of building an enterprise open source VOIP System on Linux. 3CX is an open standard software-based IP PBX system which offers a complete Unified Communications for your Business.
By using 3CX, it becomes so easy to install, manage and maintain your PBX, whether on an appliance, dedicated server in your premise, virtual machine or deployed on the cloud. From the 3CX website, the recommended operating system for running 3CX is Debian, which can be Stretch or Jessie release as of this writing.
Note that 3CX provides both free and commercial versions of the software. For comparison, check 3CX Edition Comparison page.
How to Install 3CX on Ubuntu 18.04
The good thing about 3CX installation is that they provide a script which automates most of the tasks. The script will install and configure PostgreSQL database server, 3CX packages, and configure Nginx proxy server.
Follow steps provided here to install and configure 3CX on your Ubuntu 18.04 server.
Step 1: Update your system packages
Let’s start by ensuring all system packages are updated:
sudo apt-get update sudo apt-get upgrade
You may consider doing a reboot after an upgrade:
Step 2: Install 3CX GPG key and add repository
Next step is to import GPG key used for 3CX repository:
wget -O- http://downloads-global.3cx.com/downloads/3cxpbx/public.key | sudo apt-key add -
Add the repository to the system:
echo "deb http://downloads.3cx.com/downloads/debian jessie main" >/etc/apt/sources.list.d/3cxpbx.list
Update repository list:
sudo apt-get update
Step 3: Install dependency packages and 3cxpbx package
Install dependency packages required like below:
sudo apt-get install libicu52 libssl1.0.0 libcurl3=7.38.0-4+deb8u5
sudo apt-get install 3cxpbx
This is a fully automated installation, you just relax and wait for it to complete. On success, a message is printed on your screen:
Step 4: Open 3CX Web interface
Now open 3CX Web portal using URL shown after the installation to finish the setup. Get your free license key from here https://www.3cx.com/voip-ip-pbx/
Once you get the license key, paste it on License key box and click “Next”
Next configurations are for:
- Configure login username and password
- Confirm your IP address or set new one
- Select the type of Public IP
- Select your preferred Subdomain/FQDN
- Port selection for Web services (HTTPS/HTTP) and VoIP (SIP and Tunnel)
- Select the default network adapter
Wait for domain setup to complete then:
- Select Extension Length
- Set Admin Email
- Select Country and Time Zone
- And all other settings asked
On completion, you’ll be shown installation details with “Congratulations Your 3CX Installation is ready” message. You can access the 3CX Management console from this URL: https://xx.3cx.co.za:5001 or via IP: https://ip-address:5001
You should get admin interface for Administering 3CX PBX system.
If you ever need to re-install 3CX, clean the installation first by running:
sudo /usr/sbin/3CXWizard --cleanup
Enjoy using 3CX!. Check more articles on VoIP articles section.