Ubuntu Tricks

Ubuntu Linux tricks, guides and many more…

Install Asterisk GUI on Ubuntu Server

  Asterisk (5), Ubuntu Server (24)

  15 December 2011

This guide was updated to a newer version: http://ubuntu-tricks.com/how-to-install-asterisk-gui-on-ubuntu/

In this tutorial I will describe the steps required to install Asterisk GUI on a Ubuntu Server system. This guide should work on both Ubuntu Server or Desktop edition, any version. I used this method to install the app on a few versions, between 8.04 to 11.10. Also, it is required to already have installed Asterisk (if you don’t already have Asterisk installed, you can do it using this guide). First step is to download the sources from the Digium SVN. If you don’t have subversion installed, you can install it with the following command:

sudo apt-get install subversion

Now, using Subversion, checkout the SVN URL, with this command:

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

Now you have downloaded the Asterisk GUI sources into the asterisk-gui/ directory. Go inside that directory (cd asterisk-gui)  and start compiling the app:

make install

If everything worked fine, now you have Asterisk GUI compiled and installed. You need to enable the embedded web server and HTTP manager, so edit into the /etc/asterisk/http.conf the following two modifications:

  • remove comments for the lines:
  • change bindaddr= to bindaddr=
Also, some changes are needed into the /etc/asterisk/manager.conf file:
  • under the [general] section make sure that you have something like this:
    enabled = yes

    webenabled = yes
  • add an user account which can sign in using Asterisk GUI:
    secret = this_is_a_strong_password
    read = system,call,log,verbose,command,agent,config,read,write,originate
    write = system,call,log,verbose,command,agent,config,read,write,originate
You will use the account admin / this_is_a_strong_password (of course, change the password) to login into your Asterisk GUI.
To access Asterisk GUI, use the following URL. Just replace the dummy IP with your machine IP, or if you are working locally:
Congratulations, now you have installed Asterisk GUI on your server.


Billy Eichner
Tue, 20th of December 2011
Hi, this is a nice tutorial and I think I have followed it all the way but I am not able to open the GUI ( Whenever I try, I get an error “Not Found" The requested URL was not found on this server". Any idea what is going wrong here.
Alexandru Mos
Wed, 28th of December 2011
Hello, sorry for the delayed answer, I was off a few days on Christmas.

The URL to access Asterisk GUI it's a bit tricky, I did not had time to investigate exactly what is happening.

First of all, see if the GUI is opened on the following addresses:

If still you can't access it, try to run make checkconfig into the asterisk-gui source folder. Here is the output of the makeconfig command on my system:

root@asterisk:/usr/src/asterisk-gui# make checkconfig
--- 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://asterisk:8088/asterisk/static/config/index.html

* Note: If you have bindaddr= in /etc/asterisk/http.conf
you will only be able to visit it from the local machine.

Example: http://localhost:8088/asterisk/static/config/index.html

* The login and password should be an entry from /etc/asterisk/manager.conf
which has 'config' permission in read and write. For example:

secret = mysecret24592
read = system,call,log,verbose,command,agent,config
write = system,call,log,verbose,command,agent,config

--- Good luck! ---
Thu, 2nd of February 2012
Hi there

I followed your instructions quite clear and easy to follow. Thank you for taking the time to do this and share it.
Thu, 2nd of February 2012
oh sorry forgot to mention

it works on ubuntu server 11.10 :-)
Wed, 22nd of February 2012

I have installed GUI 2.0 for Asterisk 1.8 on Ubuntu 10.0.4 Server 64-bit. The GUI works fine with Mozilla Firefox 10.0..2 browser but not with Internet Explorer 8. With IE 8 I get html code displayed instead of being executed like this:

* Asterisk-GUI - an Asterisk configuration interface
* Top level index page
* Copyright (C) 2009-2011, Digium, Inc.
* Pari Nannapaneni
* Erin Spiceland
* See http://www.asterisk.org for more information about
* the Asterisk project. Please do not directly contact
* any of the maintainers of this project for assistance;
* the project provides a web site, mailing lists and IRC
* channels for your use.
* This program is free software, distributed under the terms of
* the GNU General Public License Version 2. See the LICENSE file
* at the top of the source tree.

Asterisk Configuration GUI

Apply Changes

any idea what could cause this ? I have same problem wih 2 different PC (one with XP,1 with WIndows7- but both with IE 8)
Alexandru Mos
Sun, 26th of February 2012
Looks like the Asterisk GUI it is not sending (any?) correct content type and IE does not detects it.

I'm sorry but I don't know what to say in this case...
Wed, 29th of February 2012
I'm sure that the tGUI content is correct - at least Firerfox browser has no problem with it and GUI works fine with it.

Just checked now with IE 9 and same problem: the whole html code of the index page is just displayed, but not executed ! Even in compatibility mode...
Mon, 6th of May 2013
I got stuck on the make install and think this way might be easier for people like me who aren't used to installing stuff like that.

I ran into this Asterisk installation tutorial, it seemed to help http://draalin.com/community/index.php?threads/for-those-interested-in-vo-ip-systems.74/

Just wish I was better @ this stuff lol.
pre owned cartier love bracelet
Wed, 17th of June 2015
Your final stop be pink gold cartier love bracelet fore heading back into village was a little make shift village. This consisted o cartier love bangle fake f several pink gold cartier love bracelet tin and wood someone room shacks where people were scurrying backward and forward trying to make a quick buck. In my at cartier love bracelet 18k yellow gold tempt to let anyone enjoy a piece of the
левый заработок 7 букв
Tue, 23rd of June 2015
Hello, after reading this remarkable paragraph i am as well glad to share my experience here with colleagues.

Leave a Reply