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

Burn the Raspbian Stretch Lite image file via Etcher or Win32 Disk Imager

  1. Download the Raspbian image.
  2. Extract the image (.img) file from the downloaded archive.
  3. Burn the Raspbian image file via Etcher.

Step 3: Install Raspbian and set Hostname

Installing Raspbian and setting Hostname

  1. Insert the SD card in the Raspberry Pi memory card slot and power the device to boot.
  2. Wait for the boot process to complete and login with the default user pi and password raspberry.
  3. Run the Raspbian configuration utility with the command:
    sudo raspi-config
  4. Select 1. System Options and press the <Enter> key.
  5. Select S4 Hostname, press the <Enter> key and then OK on the warning dialog.
  6. Enter the Pi's hostname using only alphanumeric characters and dashes (“-”).
  7. Select <Finish> and then <Yes> to reboot and apply the hostname configuration.

Step 4: Set a Static IP

Setting up a static IP

  1. Edit the /etc/dhcpcd.conf file to configure the ethernet interface eth0 with the nano editor:
    sudo nano /etc/dhcpcd.conf
  2. 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:

#Ethernet static IP configuration

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

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.

  1. Press the Ctrl + x key combination, then y and <Enter> to confirm writing changes to the file.
  2. Reboot the Pi using:

sudo reboot

  1. 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

  1. Log in to the 3CX Web Client and navigate to “Admin > Voice & chat”.
  2. Click on “+ Add SBC”, select “Raspberry Pi” and click “Continue”.
  3. The SBC has now been created.

Step 6: Install 3CX SBC

  1. Log in to the Raspberry Pi as user pi via the CLI or SSH.
  2. Run the 3CX install script:
    wget http://downloads-global.3cx.com/downloads/sbc/3cxsbc.zip -O- | sudo bash
  3. Select <OK> to verify the “3CX Pre-requisites” and accept the “End-user License Agreement” to continue.
  4. Enter the “Provisioning URL” for your 3CX, e.g. https://mycompany.3cx.com:5001, and select <OK>.
  5. Enter the “Authentication KEY ID” and select <OK>.
  6. 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

Last Updated

This document was last updated on 28 February 2024

https://www.3cx.com/docs/installing-pbx-raspberry-pi/ 

Discuss this article