From Alpine Linux
Revision as of 09:46, 17 November 2023 by Sertonix (talk | contribs) (replace /etc/init.d with rc-service)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
This material is obsolete ...

The FreePBX version on this page is EOL for nearly a decade, please update it to FreePBX 13 or 14 (Discuss)

This document will be a quick c/p guide to setup asterisk with FreepPBX on Alpine Linux. What we will setup is the following:

  • Lighttpd with PHP using FastCGI
  • MySQL server
  • Freepbx 2.7.0

Install Lighttpd and PHP

Basic Installation

For installing the additional packages first activate community packages and update the package index

Install the required packages:

# apk add lighttpd php82 fcgi php82-cgi

Configure Lighttpd

Edit lighttpd.conf (/etc/lighttpd/lighttpd.conf) and uncomment the line:

Contents of /etc/lighttpd/lighttpd.conf

... include "mod_fastcgi.conf" ...

Edit mod_fastcgi.conf (/etc/lighttpd/mod_fastcgi.conf), find and change /usr/bin/php-cgi to /usr/bin/php-cgi82.

Contents of /etc/lighttpd/mod_fastcgi.conf

... "bin-path" => "/usr/bin/php-cgi82" # php-cgi ...

Start lighttpd service and add it to default runlevel

# rc-service lighttpd start # rc-update add lighttpd default

Install pear DB

apk add php7-pear; pear install DB


Follow MariaDB installation and configuration guide to prevent errors during installation. Below is an example of necessary steps, but it won't work before you do following article.

apk add mysql mysql-client

Initiate databases

/usr/bin/mysql_install_db --user=mysql

Start MySQL and add to system start

rc-service mariadb start && rc-update add mariadb default

Set MySQL root password

/usr/bin/mysqladmin -u root password 'new-password'


Install asterisk (replace vserver with your kernel version).

apk add asterisk asterisk-sample-config asterisk-dahdi asterisk-cdr-mysql

Start asterisk (do not add to system start)

rc-service asterisk start


Download Freepbx


Unpack source

tar zxvf freepbx-2.7.0.tar.gz && cd freepbx-2.7.0

Add freepbx databases to MySQL

mysqladmin create asterisk -p mysqladmin create asteriskcdrdb -p

Import SQL data into MySQL

mysql -D asterisk -u root -p < SQL/newinstall.sql mysql -D asteriskcdrdb -u root -p < SQL/cdr_mysql_table.sql

Open connection to MySQL

mysql -u root -p

Create MySQL users

GRANT ALL PRIVILEGES ON asterisk.* TO asteriskuser@localhost IDENTIFIED BY 'amp109'; GRANT ALL PRIVILEGES ON asteriskcdrdb.* TO asteriskuser@localhost IDENTIFIED BY 'amp109';

Close connection


Freepbx installer does not like busybox sed so we add normal sed, we need to patch 2 files later on so we need patch (you can remove them afterwards)

apk add sed patch

Flash operator panel needs Perl

apk add perl

Start the installer (you can accept the defaults)


Finishing up

Change user/group of lighttpd to asterisk

vim +50 /etc/lighttpd/lighttpd.conf

Change permissions of lighttpd/freepbx files

rc-service lighttpd stop chown -R asterisk:asterisk /var/log/lighttpd chown -R asterisk:asterisk /var/run/lighttpd* chown -R asterisk:asterisk /var/www/localhost/htdocs/freepbx rc-service lighttpd start

Stop asterisk

rc-service asterisk stop

Patch FreePBX to support Alpine Linux File:Freepbx engine.patch.txt

cd /var/lib/asterisk/bin patch -p0 < freepbx_engine.patch

This file gets overwritten when using freepbx so we need to patch the original File:Freepbx engine.patch.txt

cd /var/www/localhost/htdocs/freepbx/admin/modules/framework/bin/ patch -p0 freepbx_engine.patch

Start Asterisk with FreePBX

amportal start

Load needed dahdi modules

modprobe dahdi modprobe dahdi_dummy

Make them load on boot

echo dahdi >> /etc/modules echo dahdi_dummy >> /etc/modules