From Alpine Linux
Jump to: navigation, search

blue.box is an open source GUI for administration and configuration of FreeSWITCH and Asterisk based VoIP systems. It supports multi-tenancy and skinning, and is completely modular.

Install Lighttpd

Install the additional packages:

apk add lighttpd php5-common php5-iconv php5-json php5-gd php5-curl php5-xml php5-pgsql php5-mysql php5-imap php5-cgi fcgi

apk add php5-pdo php5-pdo_pgsql php5-pdo_mysql php5-soap php5-xmlrpc php5-posix php5-mcrypt php5-gettext php5-ldap php5-ctype php5-dom

Configure Lighttpd

Edit lighttpd.conf

vi /etc/lighttpd/lighttpd.conf

Uncomment line:

include "mod_fastcgi.conf"

Edit mod_fastcgi.conf

vi /etc/lighttpd/mod_fastcgi.conf

Edit the section:




Start lighttpd service and add to needed runlevel

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

Configuring postgresql

apk add postgresql postgresql-client git /etc/init.d/postgresql setup

Starting http service and adding to boot

/etc/init.d/postgresql start && rc-update add postgresql default

Installing FreeSwitch

First use apk to install the needed software parts.

apk add freeswitch freeswitch-flite freeswitch-sounds-en-us-callie-8000 freeswitch-sample-config

Change the permissions of /etc/freeswitch/

chown lighttpd:lighttpd /etc/freeswitch/ chmod 777 -R /etc/freeswitch/


Starting http and sql server and adding to boot

/etc/init.d/postgresql setup /etc/init.d/postgresql start && rc-update add postgresql default /etc/init.d/lighttpd start && rc-update add lighttpd default

Installing 2600hz

Create a webapps folder

mkdir /usr/share/webapps/ -p

Checkout the source code from the git repository

cd /usr/share/webapps/ git clone git://source.2600hz.org/bluebox.git bluebox/

Change the folder permissions

chmod -R 777 /usr/share/webapps/bluebox

Create a symlink to the create directory

ln -s /usr/share/webapps/bluebox/ /var/www/localhost/htdocs/bluebox

Configuring bluebox

Log on your bluebox

Browse to: http://WEBSERVER_IP_ADDRESS/bluebox and start configuration.

  • Welcome to Bluebox 1.0 Setup Wizard

Accept Terms and Conditions Next

  • Initial Configuration

Select pqsl as database server, bluebox as database name, postgres as user, no password Set Default Timezone

Note: Set Port to 3306 (for mysql); see - http://tickets.2600hz.org/browse/BLUEBOX-445


  • Create Main Administrator

Master Administration Account

Email Address:youremail@yourserver.net Password:adminpassword Confirm Password:adminpassword


  • Telephony Engine

In Telephony Configuration

Conf Directory: /etc/freeswitch

Global Sound File Directory: /usr/sounds


Conflicting configuration files will be permanently erased if you continue!


  • Installation

Ready to Install


After that you will see Click here to use Bluebox 1.0!

And you finish you Bluesbox installation.

Note: If you are using the Alpine ACF, or if you change the port in the lighttpd.conf file, the go to the port you set. e.g: if you set the port to 8080, then browse to: http://WEBSERVER_IP_ADDRESS:8080/bluebox

Note: Needs PHP DOM package (apk add php-dom)

Note: This documentation need some minor fixes.