Asterisk GUI
Introduction to Asterisk GUI
Asterisk GUI is a framework for the creation of graphical interfaces for configuring Asterisk.
Download
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.
Support
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
Installation
$ ./configure
$ make
$ make install
$ make checkconfig
Configuration
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:
http.conf:
Enable http.
[general]
enabled=yes
enablestatic=yes
#bindaddr=0.0.0.0 # allow GUI to be accessible from all IP addresses.
bindaddr=127.0.0.1
# require access from the machine Asterisk is running on
bindport=8088
manager.conf
Enable manager access.
[general]
enabled = yes
webenabled = yes
[admin]
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
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:
//$IP:$PORT/$PREFIX/static/config/index.html
http show status
manager show settings
CLI> http show status
HTTP Server Status:
Prefix: /asterisk
Server Enabled and Bound to
0.0
.
0.0
:
8088
Enabled URI's:
/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/
static
/... => Asterisk HTTP Static Delivery
/asterisk/amxml => XML Manager Event Interface w/Digest authentication
/asterisk/mxml => XML Manager Event Interface
Enabled Redirects:
None.
CLI> manager show settings
Global Settings:
----------------
Manager (AMI): Yes
Web Manager (AMI/HTTP): Yes
TCP Bindaddress:
0.0
.
0.0
:
5038
HTTP Timeout (minutes):
60
TLS Enable: No
TLS Bindaddress: Disabled
TLS Certfile: asterisk.pem
TLS Privatekey:
TLS Cipher:
Allow multiple login: Yes
Display connects: Yes
Timestamp events: No
Channel vars:
Debug: No
Block sockets: No
Software License
Asterisk GUI HTML and Javascript files Copyright (C) 2006-2011 Digium, Inc.
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.