Installation on Debian 12 (Bookworm)

Operating System Installation

Download the installation disk ISO image from www.debian.org:

• 64-bit: https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-12.1.0-amd64-netinst.iso

Start the installation.

Boot Menu

In the boot menu, select Install.

Language

Select the language in which the system will be installed.

Location

Select the location where you are located.

Keyboard Layout

Select your preferred keyboard layout.

Hostname

Set the computer name (hostname).

Domain Name

Set your domain name. This field can be left empty.

Root Password

Set the password for the root system administrator.

User Account — Full Name

Enter the first and last name for the user that will be used for regular non-administrative work.

User Account — Login Name

Enter the login name.

User Account — Password

Set the password.

Disk Partitioning — Method

Select the disk partitioning method. In our case, for illustration purposes, we will choose the simplest method — guided using the entire disk.

Disk Partitioning — Disk Selection

From the list of available disks, select the one on which the system will be installed. Existing data on the disk will be lost.

Disk Partitioning — Partition Scheme

Select the method of dividing the disk into one or more partitions.

Disk Partitioning — Summary

If you wish to set up software disk mirroring (RAID), you can do so in this step by selecting the option — Configure software RAID. If not, proceed to the next step.

Write Changes to Disk

Write the partition changes to the disk.

Package Manager — Media Scanning

If you don’t need to, do not scan additional installation media.

Package Manager — Location

Select the location closest to the installed computer.

Package Manager — Archive Mirror

Select a package archive mirror.

Package Manager — HTTP Proxy

If you use an HTTP proxy server to access the internet, enter the required information here, or leave it empty.

Package Popularity Survey

Do not participate in sending information about installed packages.

Software Selection

Here it is sufficient to keep SSH server and Standard system utilities enabled. All other required software packages will be installed automatically during the PBX installation.

GRUB Boot Loader — Installation

Install the GRUB boot loader.

GRUB Boot Loader — Partition Selection

Select the partition on which the system boot loader will be installed.

Installation Complete

Logging into the System

After installation, log in to the system using the root user and the password you set, or using the user you created during the installation process.

---

PBX Installation

Downloading and Running the Installer

Using the following commands, download the current version of the installer, set its permissions, and then run it.

wget http://www.voipsun.cz/pbx/install_debian_12_pjsip.sh
chmod 777 install_debian_12_pjsip.sh
./install_debian_12_pjsip.sh

Installer Language

Select your preferred installer language. Use the arrow keys to navigate and the spacebar to confirm your selection. Then continue by pressing ENTER.

Installation Confirmation

Confirm to proceed with the PBX installation. After this step, the required software packages will be installed on the system.

Wireshark — Permissions

Allow regular users to capture packets.

Package Installation Complete

After installation, you will be informed by a message. Confirm to continue with the installation.

MySQL Database Configuration

MySQL Server Address

Enter the address or domain name of the MySQL server. In our case, the PBX will be installed on the same server where MySQL is installed. Therefore, leave the value localhost and confirm with ENTER.

Database Name

Enter the database name. This database will be used by the PBX to store settings and call history. Confirm the pre-filled value with ENTER.

Database User

Enter the database username. This user will be used by the PBX application to access the database. We recommend keeping the pre-filled value or setting your own user.

Database Password

Set the password for the new user.

Password Confirmation

Re-enter the password for the new user.

Asterisk Configuration

System User

Enter the name for the system user. The main PBX application will run under this unprivileged user. If you enter root here, the application will run under the administrator account.

Installation Prefix

If you wish to install the PBX in a different directory, enter its full path here, otherwise leave the word default. Example: /opt/ustredna

TFTP Server

Set the directory for the TFTP server. Alternatively, keep the pre-filled value.

Time Zone and Date/Time Format

In the menu, you can set the time zone, time and date format, or the day the week starts. If the pre-filled values are suitable, press key 5, or use the arrows to navigate to Continue to next step and confirm with ENTER.

Continent Selection

City Selection

Time Format

Set the time format.

Date Format

Set the date format.

First Day of the Week

Select the first day of the week.

SSL Certificate

Generate an SSL certificate for the PBX web server.

Fill in the information required to generate the SSL certificate. Alternatively, keep the default values. Navigate between fields using the up and down arrow keys. Edit by typing text normally. Move to the next step by pressing ENTER.

Downloading and Installing Asterisk

In the next step, the latest versions of the following programs will be downloaded:

• Asterisk 20 — VoIP PBX
• DAHDI — timer, ISDN30/ISDN2 driver
• LibPRI — signaling (optional program)
• SpanDSP — software fax support
• PtLIB — miscellaneous tools (Portable Tools Library)

Note

If you do not have a hardware card with an ISDN30 interface installed, you can skip the LibPRI installation.

Installation Summary

Summary of programs that will be installed in the next step. After confirmation, the PBX programs will begin installing. After that, the PBX web interface and its components will be downloaded. Then the final installation will take place, followed by a settings summary.

International Dialing Code

Enter the international dialing code of your country. E.g., Czech Republic — 420, Slovakia — 421.

Final Summary

---

License Installation

Finding the IP Address

After installing the PBX, find the PBX IP address using the command:

ip a

In our case, we have the address 172.16.205.134 on the eth0 network interface. Your address will most likely differ.

Uploading the License via Web Interface

In the next step, enter the discovered address in your web browser: https://172.16.205.134. A page will appear with information about the missing license.

If you have received a license from us, paste it here.

After pasting, click the Recheck button. The PBX web interface login page will then appear.

First Login

On the first login, the system will immediately redirect you to the administration web interface. As a first step, it is recommended to create a user with administrator permissions.

Create a PBX administrator by clicking Users in the menu and then the New User button.

Enter the login name, full name, password, and enable the Is admin? option.

After creating the user, log out and log back in.

Enter your login name and password and select the web interface language.

System Configuration

Next, click Settings in the menu and then System Configuration.

Change the PBX IP address from 127.0.0.1 to the IP address you discovered.

Generating Configuration

Click Settings in the menu and then Generate Configuration.

After generating the configuration, an error message will appear, which is caused by the first login.

Ignore the message and restart the PBX using the command:

reboot

Alternatively, you can start the PBX manually with the command:

/etc/init.d/asterisk restart

After the restart, your PBX is fully installed and ready for configuration.