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

In this guide, we’ll cover the installation and configuration of 3CX on Debian 9 / Debian 8 Linux distributions. 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 system, whether in Cloud or a dedicated server in your premise. The recommended operating systems for running 3CX are Stretch or Jessie.

Install 3CX PBX on Debian 9/8

Note that 3CX provides both free and commercial versions of the software. For comparison, check 3CX Edition Comparison page.

Step 1: Update your system packages

Let’s make sure we have all packages updated.

sudo apt-get update
sudo apt-get -y upgrade

If you have Kernel updates, it is recommended to reboot your server before you continue with the installation.

sudo reboot

Step 2: Add 3CX Repository to Debian 9/8

Next is to add the 3CX packages repository to your system. Start by importing GPG key used for signing packages.

wget -O- | sudo apt-key add -

Once the key is imported, add repository.

# Add repository to Debian 9
echo "deb stretch main" | sudo tee /etc/apt/sources.list.d/3cxpbx.list

# Add repository to Debian 8
echo "deb jessie main" | sudo tee /etc/apt/sources.list.d/3cxpbx.list

Step 3: Install 3CX PBX on Debian 9/8

Update repository list and install 3CX.

sudo apt update
sudo apt install -y net-tools dphys-swapfile
sudo apt -y 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:

        _____ _______  __
       |__  // ____/ |/ /
        /_ </ /    |   / 
      ___/ / /___ /   |  

Welcome to the 3CX Configuration Tool

Press ESC to go back.

Select how to run the tool:
(1) Using a Web Browser
(2) From Command Line
Enter option: 1

Starting PbxWebConfigTool...
Launch this url from a browser on another machine:
TIP: If this is a cloud machine and the link shows a local IP address then you need to replace the local ip with your public IP Address.

Setting up nginx (1.10.3-1+deb9u2) ...
Processing triggers for systemd (232-25+deb9u11) ...
Processing triggers for libc-bin (2.24-11+deb9u4) ...

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

Once you get the license key, paste it on License key box and click “Next”

install 3cx ubuntu 18.04 01 min

Next configurations are for:

  • Configure login username and password
install 3cx ubuntu 18.04 set username min
  • Confirm your IP address or set new one
  • Select the type of Public IP
  • Select your preferred Subdomain/FQDN
install 3cx ubuntu 18.04 01 select domain min
  • Port selection for Web services (HTTPS/HTTP) and VoIP (SIP and Tunnel)
install 3cx ubuntu 18.04 configure management ports min
  • Select the default network adapter
install 3cx ubuntu 18.04 01 wait complete min

Wait for domain setup to complete then:

  • Select Extension Length
  • Set Admin Email
  • Select Country and Time Zone
  • And all other settings asked
install 3cx ubuntu 18.04 finish

You’ll be required to Create Operator Extension which will be the default destination for inbound calls. Also confirm the Voice Mail extension that will allow users to retrieve their voice mail.

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: or via IP: https://ip-address:5001

install 3cx ubuntu 18.04 login page min

You should get admin interface for Administering 3CX PBX system.

install 3cx ubuntu 18.04 admin interface min

If you ever need to re-install 3CX, clean the installation first by running:

sudo /usr/sbin/3CXWizard --cleanup

Enjoy using 3CX!. Read more on 3CX documentation and check more articles on VoIP articles section.

Other PBX installation guides:

How to Install FreePBX 15 on Ubuntu 18.04 / 16.04 / Debian 9

How to Install Asterisk 16 LTS on Ubuntu 18.04 / 16.04 / Debian 9

How to install SIPp testing tool on Ubuntu 18.04 / Ubuntu 16.04

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


Please enter your comment!
Please enter your name here