<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/2042/1/7/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+GUI">Asterisk GUI</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~espiceland">Erin Spiceland</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="AsteriskGUI-Introduction"></a>Introduction</h1>
<p>Asterisk GUI is a framework for the creation of graphical interfaces for configuring Asterisk. Some sample graphical interfaces for specific vertical markets are included for reference or for actual use and extension.</p>
<h1><a name="AsteriskGUI-SoftwareLicense"></a>Software License</h1>
<p>Asterisk-GUI HTML and Javascript files Copyright (C) 2006-2011 Digium, Inc.</p>
<p>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.</p>
<p>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.</p>
<p>Please contact Digium for information on alternative licensing arrangements for Asterisk GUI.</p>
<h1><a name="AsteriskGUI-Support"></a>Support</h1>
<p>Please note that the Asterisk GUI is not officially supported, though bugs, patches, and feature requests may be submitted at <a href="http://bugs.digium.com" class="external-link" rel="nofollow">http://bugs.digium.com</a> and should reference the GUI project.</p>
<h1><a name="AsteriskGUI-Installation"></a>Installation</h1>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[$ ./configure
$ make
$ make install]]></script>
</div></div>
<h1><a name="AsteriskGUI-Configuration"></a>Configuration</h1>
<p>You may install sample configuration files by doing "make samples". Also you will need to edit your Asterisk configuration files to enable the GUI properly, specifically:</p>
<p>#In http.conf:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[[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]]></script>
</div></div>
<p>#In manager.conf</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[general]
enabled = yes
webenabled = yes]]></script>
</div></div>
<p>#Create an appropriate entry in manager.conf for the administrative user (PLEASE READ THE security.txt FILE!)</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[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]]></script>
</div></div>
<h1><a name="AsteriskGUI-Troubleshooting"></a>Troubleshooting</h1>
<p>#Check your filesystem permissions:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[$ chown asterisk:asterisk /etc/asterisk/*.conf # if asterisk runs as the user "asterisk"
$ chmod 644 /etc/asterisk/*.conf]]></script>
</div></div>
<p>#Check that the bindaddr value in /etc/asterisk/http.conf matches the IP address of the machine you're using to access the GUI.</p>
<p>#Check that the dahdi_genconf script runs correctly.</p>
<p>#Check the existence of /etc/asterisk/guipreferences.conf and inside that file, the existence of the following line:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[config_upgraded = yes]]></script>
</div></div>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;">
<a href="https://wiki.asterisk.org/wiki/users/viewnotifications.action" class="grey">Change Notification Preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+GUI">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+GUI?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>