How To Install The Asterisk Web-Based Provisioning GUI

Not sure if you're like me, but command line is all good, but GUI is a lot faster. Here is a list of procedures to install the Asterisk GUI on a running clean install of Asterisk.

You'll need:

• Concurrent Versions System (CVS)
• asterisk 1.4 - and all modules needed to compile and install asterisk 1.4

Preparation

Go to your installation directory (for example /usr/src) and download the latest version of asterisk-gui. To do this just execute the command:

svn checkout http://svn.digium.com/svn/asterisk-gui/trunk asterisk-gui

By executing this command the sources of Asterisk GUI will be downloaded (see our sample output log svn.log) into ./asterisk-gui/ directory.

Configuring, Compiling And Installing

You first need to go into the src directory where you downloaded the files, ie: /usr/src/asterisk-gui, then you need to configure, so type

./configure

Now, you need to compile the sources by executing the command:

make

Then distribute the compiled code by executing the command

make install

With this step you will finish the installation of the asterisk-gui (see our sample output log make_install.log).

Configuration

It is recommended to back up your configuration files before you continue. To achieve this just copy /etc/asterisk under a different name:

cp -r /etc/asterisk /etc/asterisk.backup

It is recommended to run:

make samples

This command will modify some of your Asterisk configuration files. After that you'll have to finish the configuration modification manually.

There are two files which you should modify that are located in /etc/asterisk/:

manager.conf

enabled = yes
webenabled = yes

We will have to add a new user to manager.conf (we will use the mark user as previously set up when we installed Asterisk):

[mark]
secret = mysecret
read = system,call,log,verbose,command,agent,user,config
write = system,call,log,verbose,command,agent,user,config

Now we need to  make some modifications to the http.conf file:

http.conf

enabled=yes
enablestatic=yes
bindaddr=0.0.0.0

(If you set the bindaddr to 127.0.0.1 (loopback) you will only be able to access the GUI from the server itself.)

After that run

make checkconfig

in your asterisk-gui directory. This script will check if your GUI is correctly configured.

Running asterisk-gui

In order to load the asterisk-gui, Asterisk must restart/reload. You can reload your Asterisk server from your CLI console by executing the command

reload

You can use the asterisk-gui from these addresses (127.0.0.1 is the loopback IP if you're accessing the page from the server itself, or from a different system, type the Asterisk server IP address):

http://127.0.0.1:8088/asterisk/static/config/cfgbasic.html
http://127.0.0.1:8088/asterisk/static/config/cfgadvanced.html