The WebIssues Server Manual
Issue tracking and team collaboration system

Installing the WebIssues Server

This chapter lists the steps required to install a new instance of the WebIssues Server.

  1. Download and unpack the webissues-server package. Move all files from the unpacked directory to the web server's document root or your public HTML directory. Refer to the appropriate documentation for more information about configuring the web server.

  2. Create a database and a user with sufficient privileges to create tables. The Database chapter contains instructions for creating the database using the standard command line tools. If you are using a different tool for managing the databases, refer to the relevant documentation for more information.

  3. Create the storage and log subdirectories in the server's location. Make sure they are writable for the web server and not accessible for anyone else.

  4. Copy config/ to config/ and edit the created file to configure database connection and other settings. See Configuration for more information.

  5. Point your browser to the setup.php script in the server's location, for example and follow the installation steps. The script will check the configuration, create the database tables, set up the administrator account and import an initial set of issue types.

After the setup is finished, you will be able to connect to your server using the WebIssues Desktop Client application to configure the projects, folders, issue types and user accounts. Use the location of the index.php script as the server's URL, for example

If you wish to use email notifications, configure a cron job or Scheduled Task to periodically execute the cron.php script and make sure the mailing engine is configured correctly. Refer to the Notifications section for more details.


Make sure the configuration file, file attachments and server logs are not accessible for unauthorized users. See the Security chapter for more information about security settings.

You can check if the WebIssues Server is working by opening its URL in the browser. It will connect to the database, test if it is configured correctly and display a status message. You can also use the error log to check if there are any problems.