Tutorials: 3CX SBC Update Debian 10 to Debian 12

• It is recommended to download the Debian 12 SBC ISO from portal.3cx.net or from the direct link. Numerous quality of life improvements are made to the latest ISO that are not included in the upgrade process listed below.


• Upgrade to 11 is required before upgrading to 12


• The following process has not been thoroughly tested, and success rate could vary depending on any modifications you have made to your SBC, proceed with caution and at your own risk!

1. SSH into SBC with Root Access & Run the following Commands

apt-get -y update

apt-get -y upgrade

apt-get -y full-upgrade

deb http://deb.debian.org/debian bullseye main contrib non-free
deb http://security.debian.org/debian-security bullseye-security main
deb http://deb.debian.org/debian bullseye-updates main contrib non-free
EOF

apt-get update -y && apt-get -y upgrade && apt-get -y autoremove --purge

If prompt say YES or Y to Configuring “libpam0g:amd64” – Any questions YES

apt-get -y full-upgrade

shutdown -r now

2. SSH back into SBC with Root Access & Run the following Commands

systemctl status 3cxsbc

3. Verify Upgrade Completed

hostnamectl

1. SSH into SBC with Root Access & Run the following Commands

deb http://deb.debian.org/debian bookworm main
deb http://deb.debian.org/debian-security/ bookworm-security main
deb http://deb.debian.org/debian bookworm-updates main
EOF

rm /etc/apt/sources.list.d/3cxpbx*

apt install wget gnupg2 -y

wget -O- https://repo.3cx.com/key.pub | gpg --dearmor | tee /usr/share/keyrings/3cx-archive-keyring.gpg > /dev/null

echo "deb [arch=amd64 by-hash=yes signed-by=/usr/share/keyrings/3cx-archive-keyring.gpg] http://repo.3cx.com/3cx bookworm main" | tee /etc/apt/sources.list.d/3cxpbx.list

apt-get -y update

apt-get -y upgrade

2. NF Table Prompt

If you are running NF tables you can make your adjustments if necessary or press "N" for the default setting

3. Continued Commands

apt-get -y full-upgrade

After the upgrade is completed your SBC should be upgraded to debian 12, you can verify with the hostnamectl command below

hostnamectl

We recommend giving the SBC one more reboot, but no required.

shutdown -r now

Once SBC is back up verify it is operational in the 3CX console and phones are connected.

SBC blocks SSH or does not come up you can try the following commands to fix the problem

apt install zstd

apt remove iptables

dpkg-reconfigure openssh-server

apt install emacsen-common

apt install iamerican ispell publicsuffix task-english wamerican

dpkg-reconfigure openssh-server

apt-get update -y && apt-get -y upgrade && apt-get -y autoremove --purge

dpkg-reconfigure openssh-server

shutdown -r now