Installing 3CX on Debian Linux - Manual
pixel500w-500x1
Zero Admin
With the new Dashboard
pixel500w-500x1
Bulletproof Security
With SSL certs and NGINX
pixel500w-500x1
Install on $150 Appliance
Intel MiniPC architecture
pixel500w-500x1
New, Intuitive Windows Client
More themes, more UC
pixel500w-500x1
More CRM Integrations
Scripting Interface to add your own
pixel500w-500x1
Improved Integrated Web Conferencing
iOS and Android apps included
pixel500w-500x1
Personal Click2Meet URLs

Installing 3CX on Linux

Installing 3CX on Debian Linux

On this topic

Installing 3CX on Debian Linux

System Requirements

Supported Operating Systems

Supported VM Platforms

Hardware requirements

Network & Firewall Requirements

Other requirements

Step 1: Preparing Your Host Machine for Installation

Step 2: Install 3CX

See Also

System Requirements

Supported Operating Systems

Note: Don’t try it on different versions of Debian, on different Linux distributions or on Raspberry PI. It won’t work.

Supported VM Platforms

3CX Phone System is extensively tested to be run as a VM which eliminates the cost of separate hardware and adds high availability solutions based on the hypervisor infrastructure. Tested and supported hypervisor platforms are:

  • VMware ESX 5.X and above.
  • Microsoft HyperV 2008 R2 and above. See our Hyper-V Page for the specific settings for running 3CX.
  • KVM
  • Citrix XenServer 7.0 and above
  • Amazon AWS
  • Google Cloud Engine Instance

Avoid using 3CX Phone System on converted VMs (P2V) because a converted virtual machine might have timing issues, which causes the guest operating system not to sync with the timer of the hypervisor.

Hardware requirements

System performance depends on five key factors:

  • How many simultaneous calls will the system handle.
  • How many people will simultaneously connect to the presence server.
  • If call recording is used.
  • If VoIP Providers are used.
  • If call routing built is mainly around queues and IVRs.

Based on these factors the hardware can vary from Intel i3 CPUs with 4Gb of RAM up to a multi socket/core system. General guidelines can be found online in these articles:

Network & Firewall Requirements

In case local devices, such as 3CX Client and IP phones are connecting to the 3CX within the LAN or via VPN site-to-side connections, it MUST be ensured that the IP address (range) is as per definition  in RFC 1819 on client and server side. Connection from non RFC 1819 networks to 3CX are restricted in the use of HTTP and SIP.

If 3CX is installed behind a NAT device, ports need to be forwarded. See the following guides detailing the requirements:

Other requirements

  • Latest version of Firefox, Google Chrome, Internet Explorer or Edge.
  • A constant internet connection to activation.3cx.com on port 443.
  • On demand HTTP and HTTPS connection to downloads.3cx.com/* for 3CX Management Console downloads and additional information.

Step 1: Preparing Your Host Machine for Installation

Tasks that MUST be completed before installing 3CX:

  1. Assign a static internal IP address to the host machine’s network adapter using DHCP.
  2. If the host machine has multiple network adapters:
  • Disable unused network interfaces / Wi-Fi adapters.
  • Just ONE default gateway! DO NOT configure multiple adapters with default gateways!
  1. Keep this linux instance dedicated to 3CX - don’t install other software
  2. Ensure that all power saving options are disabled

Step 2: Install 3CX

  1. Connect to the machine using SSH and enter the following commands:

wget -O- http://downloads.3cx.com/downloads/3cxpbx/public.key | apt-key add -

echo "deb http://downloads.3cx.com/downloads/3cxpbx/ /" | tee /etc/apt/sources.list.d/3cxpbx.list

apt-get update

apt-get install 3cxpbx

  1. Now 3CX will be downloaded and installed. When done you will see the following.

  1. Select option 1. The 3CX Web Application will start.

1.png

  1. Go to another computer, launch a browser and navigate to http://IPADDRESS:5015 - as shown in the screenshot above.
  2. Now run the 3CX configuration tool which will guide you through the initial setup of your PBX. See the 3CX PBX Configuration Tool documentation here.

See Also

<