¶ PBXware installation on Ubuntu
¶ Ubuntu ISO
To install PBXware, we first need to install Ubuntu on our machine. To do this we have to download an ISO and prepare an installation medium.
We recommend the following Ubuntu Server version:
- Ubuntu 26.04.1 LTS (available on this link)
NOTE: The steps and screenshots below show the process of installing Ubuntu 24.04.1 LTS and then installing PBXware 7.x on that system. The procedure for PBXware 8.x on Ubuntu 26.04.1 LTS is the same, so you can use these instructions as well.
The easiest way to install the system on a machine is by using a USB drive. To prepare the USB drive for installation, we need to make it bootable using a suitable program. We recommend using Balena Etcher (available here).
If you are on a Windows machine, download the installer and run it, but if you are on a Linux machine then the simpler option is to:
- download the latest AppImage
- cd into the Downloads folder
- give it run privileges with: chmod +x ./balenaEtcher-.AppImage
- run it with ./balenaEtcher-.AppImage --no-sandbox
You should see this window appear. From here, select the downloaded ISO and the drive, and press Flash.
When turning on your machine, make sure to boot into the flashed USB drive.
After some time, you should see this screen:
Select Ubuntu Server:
The installation will auto-detect the available network:
Modify it if you need something different.
This step checks for suitable update servers for your machine:
Select a drive on which to install the OS itself, or create a custom layout. The default option will overwrite the entire disk, and data will be lost if there is any on it.
Enter your credentials:
Check the Install OpenSSH server box to allow SSH connections:
Ubuntu will proceed with the installation:
Once the installation is complete, choose Reboot Now and remove the installation medium.
Now enter your credentials to log into the Ubuntu system.
Now that Ubuntu has been successfully installed, we can proceed with the installation of PBXware.
¶ PBXware installation
To download the script for the PBXware installation, run the following:
wget https://downloads.bicomsystems.com/updates-7x/install-script/install-pbxware-v7x.sh.gz
Replace 7x with the actual version to download.
Example:
wget https://downloads.bicomsystems.com/updates-7.4.0/install-script/install-pbxware-v7.4.sh.gz
Run the following commands to unpack the script and give it execute permissions:
-
gunzip install-pbxware-v7x.sh.gz
-
chmod +x install-pbxware-v7x.sh
- Run ./install-pbxware-v7x.sh and follow the prompts
It is recommended to first log into sudo using sudo su and then run the install, but you can enter sudo ./install-pbxware-v7x.sh
IMPORTANT:
During the initial steps of the installation, you will be prompted to enter a New password and to Retype new password. Make sure to remember this password, as it will be required for the initial login to the Setup Wizard.
After successfully running the installation script, you should see this:
Both services should now be running (pbxware and setupwizard):
The installation is now complete, and the system is ready for further configuration in the Setup Wizard.
¶ Accessing the Setup Wizard
To access the Setup Wizard, open a web browser and enter your system's IP address followed by port 81.
NOTE: To find your IP address, you can use the following command:
ip a
The IP shown in the output is the one you will use to access PBXware.
NOTE: In the example below, the IP is 192.168.122.252, but users should enter their own IP on port 81 to reach the Setup Wizard.
Connect to this system to configure PBXware.
NOTE: Log in using the password you set when prompted by the installation script.
¶ systemctl
The systemctl command is used to manage and interact with systemd services on Linux. It can start, stop, restart, and reload services, as well as provide information about their status.
systemctl start / stop / restart / reload pbxware.service
systemctl start / stop / restart / reload setupwizard.service
systemctl status setupwizard.service
systemctl status pbxware.service
¶ journalctl
Since PBXware is running on Ubuntu, journalctl is a command-line tool that can be used to view and manage log messages created by the systemd system and service manager. It provides access to the system's event logs, including boot logs, service statuses, error messages, and other system events.
The journalctl -u command is used to filter and display log entries related to a specific systemd service or unit in Ubuntu. This is particularly useful for troubleshooting or monitoring the behavior of individual services. You can monitor pbxware and setupwizard logs as they are being written by using the -f option.
sudo journalctl -u pbxware.service -f
sudo journalctl -u setupwizard.service -f
