Installing 3CX SBC on Raspberry Pi 4
Introduction
3CX PBX is no longer supported on Raspberry Pi devices. This guide is intended to cover the set up and installation of the 3CX SBC only.
Step 1: Get the correct Raspberry Pi
- A Raspberry Pi 4 B4 or B8
- Pi5 support is coming
- Ensure the device has a good casing that allows for maximum cooling
Step 2: Prepare the SD card with Raspbian
- Download the Raspbian image.
- Extract the image (.img) file from the downloaded archive.
- Burn the Raspbian image file via Etcher.
Step 3: Install Raspbian and set Hostname
- Insert the SD card in the Raspberry Pi memory card slot and power the device to boot.
- Wait for the boot process to complete and login with the default user “pi” and password “raspberry”.
- Run the Raspbian configuration utility with the command: sudo raspi-config
- Select “1. System Options” and press the <Enter> key.
- Select “S4 Hostname”, press the <Enter> key and then “OK” on the warning dialog.
- Enter the Pi's hostname using only alphanumeric characters and dashes (“-”).
- Select <Finish> and then <Yes> to reboot and apply the hostname configuration.
Step 4: Set a Static IP
- Edit the “/etc/dhcpcd.conf” file to configure the ethernet interface “eth0” with the nano editor: sudo nano /etc/dhcpcd.conf
- Scroll to the end of the file and add the following lines, making sure to replace the values for “interface”, “ip_address”, “routers” (gateway) and “domain_name_servers” based on your LAN settings:
interface eth0 static ip_address=192.168.1.111/24 static routers=192.168.1.1 static domain_name_servers=192.168.1.1 8.8.8.8#Ethernet static IP configuration
Note: LAN installs are supported on properly configured RFC 1918 private networks, i.e. 172.16.0.0 /10.0.0.0/192.168.0.0 IP range.
- Press the “Ctrl” + “x” key combination, then “y” and <Enter> to confirm writing changes to the file.
- Reboot the Pi using:
sudo reboot
- When the Pi boots again, login with “pi” user and verify “eth0” IP address with the command:
ip a
Step 5: Add the SBC in 3CX
- Log in to the 3CX Web Client and navigate to “Admin > Voice & chat”.
- Click on “+ Add SBC”, select “Raspberry Pi” and click “Continue”.
- The SBC has now been created.
Step 6: Install 3CX SBC
- Log in to the Raspberry Pi as user “pi” via the CLI or SSH.
- Run the 3CX install script:wget http://downloads-global.3cx.com/downloads/sbc/3cxsbc.zip -O- | sudo bash
- Select <OK> to verify the “3CX Pre-requisites” and accept the “End-user License Agreement” to continue.
- Enter the “Provisioning URL” for your 3CX, e.g. https://mycompany.3cx.com:5001, and select <OK>.
- Enter the “Authentication KEY ID” and select <OK>.
- Select <OK> and proceed to install and restart.
Step 7: Provision your IP Phones
Once your SBC is installed, you can provision your IP Phones.
See Also
- Install and configure 3CX SBC on Debian and Raspbian Linux
- Learn how to Create and Convert OpenSSH Keys
- How to set up an SBC HA (High Availability) cluster.
Last Updated
This document was last updated on 28 February 2024