====== Using the Asterisk GUI ======

The **Asterisk GUI** is not the same as the **AstLinux Web Interface**.

The Asterisk GUI is an open source project created by [[http://www.digium.com/|Digium]], allowing the Asterisk configuration to be created, edited and managed via a web browser.  If you prefer to edit the Asterisk configuration via a text editor or via the Edit tab in the AstLinux Web Interface, do not use the Asterisk GUI without first understanding how the Asterisk GUI re-writes the configuration files.

!!Note: Asterisk GUI is no longer supported with AstLinux 1.2.3 and later.!!
===== Configuration Files =====

Two files are key to allowing the Asterisk GUI to operate, located at:
  * ''/mnt/kd/asterisk/manager.conf'' (or a symlink as ''/etc/asterisk/manager.conf'')
  * ''/mnt/kd/asterisk/http.conf'' (or a symlink as ''/etc/asterisk/http.conf'')

Additionally, if the file ''/mnt/kd/dahdi/system.conf'' does **not** exist, create it with the CLI command:

  cp /stat/etc/dahdi/system.conf /mnt/kd/dahdi/system.conf
  

===== Asterisk manager.conf =====

The default ''manager.conf'' should contain these settings, without editing:

  [general]
  enabled = yes
  webenabled = yes
  
  port = 5038
  bindaddr = 0.0.0.0

The username/password for the Asterisk GUI is defined in the ''manager.conf'' file.  Add/Edit a section similar to the following:

  ; THIS IS INSECURE! CHANGE THE PASSWORD!!!
  [admin]
  secret = astlinux
  ;deny = 0.0.0.0/0.0.0.0
  ;permit = 192.168.101.1/255.255.255.0
  read = system,call,log,verbose,command,agent,user,config
  write = system,call,log,verbose,command,agent,user,config

Be sure to change the password and possibly also uncomment/edit the deny/permit lines for added security.

===== Asterisk http.conf =====

The default ''http.conf'' should contain these settings, without editing:

  [general]
  ;
  enabled=yes
  ;
  bindaddr=0.0.0.0
  ;
  ; Port to bind to for HTTP sessions (default is 8088)
  ;
  ;bindport=8088
  ;
  ; Prefix allows you to specify a prefix for all requests
  ; to the server.  The default is blank.  If uncommented
  ; all requests must begin with /asterisk
  ;
  ;prefix=asterisk
  ;
  ; sessionlimit specifies the maximum number of httpsessions that will be
  ; allowed to exist at any given time. (default: 100)
  ;
  ;sessionlimit=100
  ;
  ; Whether Asterisk should serve static content from http-static
  ; Default is no.
  ;
  enablestatic=yes
  ;
  ; Redirect one URI to another.  This is how you would set a
  ; default page.
  ;   Syntax: redirect=<from here> <to there>
  ; For example, if you are using the Asterisk-gui,
  ; it is convenient to enable the following redirect:
  ;
  ;redirect = / /static/config/index.html
  ;

A new install ''http.conf'' should appear similar as above.

===== Asterisk GUI - URL =====

Restart asterisk for any of the above file changes to become active.

Access the Asterisk GUI using the following URL:

  http://pbx-ip-address:8088/static/config/index.html

Username: admin\\
Password: //secret// from ''manager.conf''\\