TryLearn More

Use SIP trunks, WebRTC & Apps

Slash your Phone Bill by 80%

Installing Raspbian Linux on Raspberry Pi

On this topic

Installing 3CX PBX on Raspberry Pi


Prepare the SD card with Raspbian

Set hostname

Set a static IP

Install 3CX PBX on Raspbian

Removing 3CX from Raspbian

See Also


Starting with v16, you can install 3CX on the latest Raspberry Pi, model 3B+. The latest version of 3CX can be installed on Raspbian Stretch, the Debian Linux distribution for the Raspberry Pi’s ARM architecture. Useful OS management functions can be performed from within the 3CX web management console or the Linux Command Line Interface (CLI) for advanced users.

Prepare the SD card with Raspbian

To install Raspbian on a micro-SD card:

  1. Download the Raspbian Stretch Lite image from here.
  2. Extract the image (.img) file from the downloaded archive.

  1. Burn the Raspbian Stretch Lite image file via Etcher or Win32 Disk Imager.
  2. Insert the written SD card in the Raspberry Pi memory card slot and power the device to boot.
  3. Wait for the boot process to complete and login with the default user pi and password raspberry.
  4. Change the default password for the pi user with the passwd command. You need to enter the old password and then specify twice the new password for the change to occur.

Note: Raspbian Linux requires the use of the sudo command to enable authorized users perform administrative tasks. For example, to check the package repositories for updates you need to issue the command sudo apt update. Issuing apt update without sudo prepended, results to denied permission for the command.

Set hostname

To set the device hostname for the Pi:

  1. Run the Raspbian configuration utility with the command:

sudo raspi-config

  1. Select 2. Network Options and press the <Enter> key.
  2. Select N1 Hostname, press the <Enter> key and then OK on the warning dialog.
  3. Enter the Pi's hostname using only alphanumeric characters and dashes (“-”).
  4. Select <Finish> and then <Yes> to reboot and apply the hostname configuration.
  5. When the Pi boots again, login with pi user and verify the Pi's hostname with the command:


Set a static IP

To set a static IP address for the Pi:

  1. Edit the /etc/dhcpcd.conf file to configure the eth0 interface with the nano editor:

sudo nano /etc/dhcpcd.conf

  1. Scroll to the end of the file and add the following lines, making sure to replace the values for ip_address, routers (gateway) and domain_name_servers based on your LAN settings:

#eth0 static IP configuration

interface eth0

static ip_address=

static routers=

static domain_name_servers=

  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:

ifconfig eth0

To setup “3CX Session Border Controller (SBC)” follow this guide to install and configure the SBC.

See Also

Free for up to 1 year! Select preferred deployment:


for Linux on a $200 appliance or as a VM

Get the ISO


for Windows as a VM

Download the setup file

On the cloud

In your Google, Amazon, Azure account

Take the PBX Express