Installing 3CX on Debian Linux
On this topic
3CX created an ISO (get ISO here) of Debian Linux dedicated to 3CX. This makes installation faster and management easier. Most of the OS management can be done from within the 3CX web management console.
We strongly recommend that you dedicate your Debian Linux instance to 3CX. Do not install other packages or change its configuration. This will prevent us from upgrading your operating system to a new version and we will not be able to support your install.
As a rule of thumb, your machine or VM will need at least one 1 CPU core and 1 Gbyte RAM (although it will run on a Google Cloud f1 micro instance with 612 mb ram for very small installs). Additional CPU time and RAM should be allocated based on:
- Number of simultaneous calls the system will handle.
- Number of active users (100 users using the web client all day is very different from 100 IP Phones in hotel rooms making the occasional call).
- If you will be using call recording (places significant load on the system because of audio mixing and writing to storage).
Suggested Hardware Specifications for different usage scenarios can be found here.
Supported VM Platforms
3CX Phone System is well suited to be run as a Virtual Machine. Tested and supported hypervisor platforms are:
- VMware ESX 5.X and above.
- Microsoft HyperV 2008 R2 and above. See our Hyper-V Page for required settings.
- Citrix XenServer 7.0 and above
Supported Mini PC’s
3CX has tested this on the following MiniPC models:
Network, Firewall & Other Requirements
- If you are installing on the local LAN, your network must be properly configured using a RFC 1918 private network (e.g. IP 172.16.0.0 /10.0.0.0/192.168.0.0 range).
- If behind a NAT device, ports need to be forwarded. See the Firewall & Router Configuration Guide how to do this.
- Latest version of Firefox, Google Chrome, Edge.
- A constant internet connection to activation.3cx.com on port 443.
- On demand HTTPs connection to downloads.3cx.com/* for 3CX Management Console downloads and additional information.
Installing Debian for 3CX
To install Debian for 3CX:
- Download the Debian for 3CX ISO from here.
- If using a hypervisor/virtualized OS set the CD option to boot from the iso and ensure the CD drive is set to connect on startup. If you are installing on a mini pc, then create a bootable image, plug it into one of the available Mini PC’s USB ports, set the BIOS to boot primarily from the USB drive and the installation will start.
- Boot your system with the ISO. Select “Install” from the main boot screen.
- Now enter a hostname for the computer so you can easily identify it on your network. NOTE: If you need to configure a static IP address, press ESC when asked for the hostname. You will be taken back to configuring the hostname when you have set the IP address of the system. If you don’t want to set a static IP address, enter a host name and go to Step 6.
- Select “Configure Network Manually” to set a static IP address.
- Enter a domain name. If this is a network, use the same domain as you use on other computers in the network, for example mycompany.com.
- Now select the language you wish to install.
- Select your geographical location from the location menu. This will update the system locale.
- Specify the root password for the machine. You will be prompted to re-enter the password for verification purposes.
- Select your timezone.
- Partition your disk. Select “Guided - use entire disk”.
- Confirm your disk. If you are installing to a bare metal machine remember that all the data on your disk will be erased!
- Select “All files in one partition”.
- Select “Finish partitioning” and write changes to disk. Debian for 3CX will be installed.
- Select Yes to start writing changes to disk. This can take about 10-20 minutes depending on your machine speed. After that the machine will be rebooted and 3CX will be installed automatically.
- After the 3CX installation is complete, you will be prompted to select how you want to configure 3CX - There are 2 options - 1 for Web Browser and 2 using command line. Select option 1 to use a web browser, and point your browser to http://<ip of machine>:5015.
- Now you go through the wizard. It will detect your IP, ask whether you are behind a NAT and confirm these options with you. You get to choose a subdomain and admin credentials for your PBX. Afterwards you will be presented with a summary page to login to your PBX. Save it and don’t lose it!! Visit this guide for step by step instructions.
Removing Debian for 3CX
In case you want to uninstall 3CX there are 2 options you can use:
- apt-get remove 3cxpbx : Use this command when you want to uninstall 3CX keeping all the 3CX Data on the machine (Recordings, Database, Data files etc). This option is useful in case you want to re-install 3CX at a later time.
- apt-get remove --purge 3cxpbx : Use this command when you want to completely remove 3CX and all 3CX associated files
If you want to install Debian and 3CX manually without using our ISO, for cases where the 3CX ISO cannot be used because the hoster does not allow custom ISOs to be uploaded, see this guide.
- Running the PBX configurator tool
- How to test Debian for 3CX on Virtualbox
- Read our guide on how to install Debian for a 3CX on a Mini PC.