Introduction to Asterisk GUI
Asterisk GUI is a framework for the creation of graphical interfaces for configuring Asterisk.
While package release is inconsistent and infrequent, you can always get a current copy of Asterisk GUI from subversion. The current stable version will always be under branches and is currently located in branches/2.0.
Please note that Asterisk GUI is not officially supported, though bugs, patches, and feature requests may be submitted at http://issues.asterisk.org and should reference the Asterisk GUI project. You may also find peer support in the #asterisk-gui IRC channel and the Asterisk GUI forum.
Installation and Configuration
$ make install
$ make checkconfig
You may install sample configuration files by doing “make samples”. Also you will need to edit your Asterisk configuration files to enable Asterisk GUI properly, specifically:
#bindaddr=0.0.0.0 # allow GUI to be accessible from all IP addresses.
# require access from the machine Asterisk is running on
Enable manager access.
enabled = yes
webenabled = yes
secret = thiswouldbeaninsecurepassword
read = system,call,log,verbose,command,agent,config,read,write,originate
write = system,call,log,verbose,command,agent,config,read,write,originate
Access Asterisk GUI via a URL formatted in the following way, where $IP is the IP address on which both Asterisk and Asterisk GUI are installed, $PORT is bindport from http.conf, and $PREFIX is the prefix from http.conf, and it can be omitted if blank.
http show status
manager show settings
CLI> http show status
HTTP Server Status:
Server Enabled and Bound to
/asterisk/httpstatus => Asterisk HTTP General Status
/asterisk/phoneprov/... => Asterisk HTTP Phone Provisioning Tool
/asterisk/amanager => HTML Manager Event Interface w/Digest authentication
/asterisk/arawman => Raw HTTP Manager Event Interface w/Digest authentication
/asterisk/manager => HTML Manager Event Interface
/asterisk/rawman => Raw HTTP Manager Event Interface
/... => Asterisk HTTP Static Delivery
/asterisk/amxml => XML Manager Event Interface w/Digest authentication
/asterisk/mxml => XML Manager Event Interface
CLI> manager show settings
Manager (AMI): Yes
Web Manager (AMI/HTTP): Yes
HTTP Timeout (minutes):
TLS Enable: No
TLS Bindaddress: Disabled
TLS Certfile: asterisk.pem
Allow multiple login: Yes
Display connects: Yes
Timestamp events: No
Block sockets: No
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 only. This software is also available under commercial terms from Digium, Inc.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Please contact Digium for information on alternative licensing arrangements for Asterisk GUI.