Learning Hub / Tutorials / 3CX / Debian 9 to Debian 10 + 3CX V16 to V18 FAQs

Tutorials: Debian 9 to Debian 10 + 3CX V16 to V18

This is no small update, so you should plan for a minimum of approx. 18 minutes of downtime. This all depends on your system specs and how much data you have on your 3CX (e.g. recordings, voicemails). If your full backup size is anywhere above 500mb, you should plan for half an hour or more.

Several of our customers that are using GCP (Google Cloud Platform) to host their 3CX, tend to have issues with the 3CX service binding to the private IP interface allocated to them by GCP. Plan your time accordingly to allow for a fresh re-install of 3CX and restore from a backup.

A few of our customers that host their own 3CX systems have reported the digital receptionist prompts are missing after updating:


Create a backup and download the Debian 10 Buster .zip file. Make sure you save it somewhere safe, such as the Desktop or Downloads.

The latest version of 3CX V16 is the build. "3CX Version 16, Update 8 FINAL" is the required version to install before the "upgrade Debian from 9 to 10" option is available in the 3CX Management Console.

Watch the email address you have configured for notifications, as failure notifications and logs will go here.

  • Note: you will also find Generic failure notifications in the 3CX MC Dashboard > Event Log

Once you are positive you have a backup downloaded to your local machine, navigate to the 3CX Management Console.

  • Select "Updates" in the top right corner. You should see "Version 18 (Includes OS upgrade from Debian 9 to 10)"
  • Select the blue "Upgrade" button when you are ready to proceed.

It will show that your 3CX Debian OS was successfully updated.

  • in apt: "Preparation: Found an uncommon source list in /etc/apt/sources.list.d/:"
  • No network connection after reboot? Check /etc/network/interfaces for "pre-up iptables-restore /etc/iptables.rules" (This needs to be removed from the /etc/network/interfaces file, then you will need to reboot.)
  • Your Hosting Provider should give you access to a VNC "Console" to manage the VM. For on-premise installs, use a monitor and keyboard to check the /etc/network/interfaces file.
  • If you are have custom iptables set, check what the equivalent is in nftables and see if they were translated correctly.
Learning Hub / Tutorials / 3CX / Debian 9 to Debian 10 + 3CX V16 to V18 FAQs