Installing The Asterisk PBX And The Asterisk Web-Based Provisioning GUI On Linux - Page 2

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



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 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


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


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).



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/:

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):

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:


(If you set the bindaddr to (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


You can use the asterisk-gui from these addresses ( 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):

Share this page:

Suggested articles

6 Comment(s)

Add comment



Thanks for the guide.  Still works well on my recent install. 

Just one problem I had (as do many others from the various comments) - on logging in to the Manager I got the message "The GUI does not have necessary privileges! -  Please check the manager permissions for the user!".  I think this is because the Asterisk configuration directory in /etc does not have the permissions of the user running Asterisk.  Almost certainly the directory is owned by root but Asterisk is running under asterisk. So just change the directory permissions to the Asterisk user.  Probably:- 

 sudo chown asterisk:asterisk /etc/asterisk

You may need to check the files in the directory are also owned by the Asterisk user. 

By: Anonymous

Still I am not able to open the full web GUI of the Asterisk. Can you help me please?


By: Paul

I had the same issue but was able to resolve it by not only changing the rights to the asterisk but giving full access to the user asterisk.

By: Samad

i was having the same error (Not found).

Then i uncomment on http.conf 

redirect = / /static/config/index.html

then save and close

then restart the asterisk service (service asterisk restart)

then i point the http://my-server-ip:8088 

hola . its comes the AMI Page.


By: pascale

404 Not Found

The requested URL was not found on this server.

asterisk server

what should i do?

By: Anonymous

Hello everyone's

my problem is, i do have a server running on the cloud with ubuntu 12.04 32 bits and lamp already installed asterisk 1.8 i do follow those steps to install asterisk gui but at the end i get on http://myserver:8088/static/config/index.html or http://myserver:8088/asterisk/static/config/index.html  or http://myserver:8088/asterisk/static/config/cfgbasic.html the next

Not Found

The requested URL was not found on this server.

Asterisk Server

i do  make checkconfig on the folder asterisk-gui installed in /usr/src/ and i get this 

 --- Checking Asterisk configuration to see if it will support the GUI ---

* Checking for http.conf: OK

* Checking for manager.conf: OK

* Checking if HTTP is enabled: OK

* Checking if HTTP static support is enabled: OK

* Checking if manager is enabled: OK

* Checking if manager over HTTP is enabled: OK

 --- Everything looks good ---

 * GUI should be available at http://myserver:8088/asterisk/static/config/index.html 

but it's not there