FreePBX 17 Installation

How to install FreePBX 17


Start with the latest GNU GPL Install Script for Debian 12 to bring up a FreePBX 17 system using the following steps

  1. Take any Debian 12 OS host or virtual machine. 

    1. explains the steps if installing Debian OS manually.

  2. Execute our GitHub hosted “install” script and that's it, you are ready to use the software. (Ref -

https://github.com/FreePBX/sng_freepbx_debian_install )

Installation script

How to execute the script

Steps -

ssh to the Debian 12 system as 'root' user and run the following commands

cd /tmp wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh -O /tmp/sng_freepbx_debian_install.sh bash /tmp/sng_freepbx_debian_install.sh


Please note that the script may take around 30 minutes or more to complete, depending on the underlying system specifications and internet speed. It is recommended to run it in the background and monitor the progress through the log file.

Logs will be available at “/var/log/pbx/freepbx17-install-<date-timestamp>.log”.

Steps performed by the Installation script -


Installation script will -

  1. Install the FreePBX dependent packages on the top of Default Debian OS.

  2. Setup the Sangoma Debian repository to fetch the Sangoma packages required for the commercial modules of the FreePBX.

Usage of the Installation script

Installation script accepts the following arguments -
Please note TWO '--' .

  1. --dahdi
    This option is used when installing FreePBX with DAHDI support, which is required for Sangoma cards. This is recommended if you plan to use FreePBX with Sangoma’s digital or analog cards. This option will also download the necessary wanpipe and DAHDI drivers.

  2. --testing
    This is useful when testing the “development” or “testing” repository. We manage two Debian repositories: “production” and “development/testing.” We first push any new or upgraded packages to the “development/testing” repository to ensure they do not cause any issues before moving them to the “production” repository.

  3. --nofreepbx
    This is useful, if you do not want to install the Freepbx package and just want to create the initial setup for the Freepbx.

  4. --noasterisk
    This is useful, if you do not want to install the Asterisk package and like to use your own asterisk.

  5. --dahdi-only
    This is used to install DAHDI support on a system that has already been installed and configured wihtout DAHDI

  6. --skipversion
    The script includes logic to check if the install script version on GitHub is more recent than the currently running script version. If the GitHub version is newer, the script will fail to execute. There is an option to bypass this version check, but using it is not recommended.

  7. --opensourceonly
    This option will allow script to install only open source modules of the Freepbx.

 

DAHDI Support

Please note that DAHDI/Wanpipe packages should be installed on the top of supported Linux kernel only.


By default, installation script is not installing the DAHDI/WANPIPE drivers.

Installation script is printing the supported kernel version during the installation so if you want to install DAHDI / Wanpipe in the future then ensure you are keeping supported kernel version only.

However, Please note that DEBIAN will keep on upgrading the Linux kernel and we will not be releasing the compatible DAHDI/Wanpipe so frequently so if you upgrade your kernel to the latest which is not supported by DAHDI/Wanpipe driver then you will have to downgrade the kernel to the supported version.

If you have plan to use the hardware then recommend way to install it during the fresh freepbx 17 installation time only by “--dahdi” option which will install the required drivers and lock the linxu kernel version also to avoid upgrading the kernel as a general OS upgrade process.

How to see latest DAHDI supported version :
Please execute below command to see the latest supported DAHDI.

apt-cache search dahdi | grep -E "^dahdi-linux-kmod-[0-9]" | awk '{print $1}' | awk -F'-' '{print $4"-"$5}' | sort -n | tail -1


How to see latest wanpipe supported version :
Please execute below command to see the latest supported wanpipe.

apt-cache search wanpipe | grep -E "^kmod-wanpipe-[0-9]" | awk '{print $1}' | awk -F'-' '{print $3"-"$4}' | sort -n | tail -1


How to see current kernel version :

Return to Documentation Home I Return to Sangoma Support