queXS Installation Manual

Requirements (1.x.x branch)

Requirements (2.x.x branch)

Requirements for VoIP integration

  • Server
    • Asterisk server (for 0.9.x series, only tested with 1.4. For 1.0.x series, 1.6 is required)
      • originate privilege required for read and write in Asterisk manager.conf.
      • Example manager.conf:

        enabled = yes
        port = 5038
        bindaddr =
        displayconnects=no ;only effects 1.6+

        secret = password
        read = system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate
        write = system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate

    • FreePBX recommended. queXS >= 1.3.0 can integrate with FreePBX for automatic operator extension configuration and management
  • Client
    • SIP or IAX client with auto answer (I recommend pjsua)


  1. Extract tar ball or zip file to a directory on your web server
  2. Create the database structure by using the database/quexs.sql file on your mySQL database server
    • It is recommended to create a database user with privileges only to the queXS database
    • This user will also need SELECT permissions of the mysql timezone tables, example:
    • GRANT select on mysql.time_zone_transition_type to quexs;
      GRANT select on mysql.time_zone_transition to quexs;
      GRANT select on mysql.time_zone_leap_second to quexs;
      GRANT select on mysql.time_zone to quexs;
      GRANT select on mysql.time_zone_name to quexs;
  3. If you don't already have a config.inc.local.php file, copy the config.inc.local.php.default file to config.inc.local.php
  4. Edit the config.inc.local.php file to point to your database and your local web paths
  5. Browse to the admin directory of the queXS installation in a web browser to begin administering the queXS system