BugList

Step 1: Download BugList

Simply go to http://sourceforge.net/project/showfiles.php?group_id=92982 and pick the version you want.

Step 2: Make sure you have a MySQL and PHP installation

You will need an installation of MySQL and a version of PHP configured to use MySQL in order for BugList to work.

When you have ensured that you have both MySQL and PHP installed, you must know the hostname, username, database, and (optionally) password you will need to connect. If you have the proper rights on your database server, the installation script can create a new database for you. Otherwise you must have a new, empty dtabase and rights to create tables in it.

Step 3: Unpack the archive

On unix you can do this by typing tar -zxvf buglist-x.y.z.tar.gz (where x, y, and z are the major, minor, and build version, repsectively).

On Windows, you can e.g. unpack the downloaded archive using WinZip.

Step 4: Copy the distribution files to your web-server

Copy the contents of the src/-directory to your webserver. You should now have 3 new directories, install, admin, and buglist.

Now is a good time to password protect access to all files in the admin-directory. You should also password-protect the editbug.php, download.php, and submitchanges.php-files in the buglist-directory. If you use Apache, you can use the supplied .htaccess and .htpasswd-files.

Step 5: Setup the database

Simply point your web-browser to the install/ directory you just installed. In most cases, you will just point your web-browser to http://localhost/install/.

Follow the instructions.

Step 6: Remove the install/-directory

Step 7: Update the configuration to suit your needs

Change buglist/setup/setup.php to suit your needs. Often you can just use the one generated by the installation program.

Step 8: Test your installation

Point your browser to the buglist/ directory. In most cases, you will just point your web-browser to http://localhost/buglist/.

You can now try to add bugs, assign bugs, etc.

Step 9: Customise your installation

You can add your own operating systems, bug categories and versions of your program using the administrative tools.

For the more advanced users, you can also customise the layout of the page by changing buglist/setup/header.html and buglist/setup/footer.html.