This document is an older, unmaintained guide. There may be a new guide available for this software.
Flyspray is an advanced bug tracking system that allows software development teams, open source software projects, and other teams to manage development progress, issue reports, feature development, and other project tasks. Written against the popular LAMP stack, and including support for email and Jabber (XMPP) notifications, Flyspray is an ideal solution for teams that want an easy to use and manage issue tracking system with advanced features.
Before beginning this guide we assume that you have completed our getting started guide. If you're new to Linux systems administration consider the guides in our using Linux section, particularly the guide for administration basics. To complete this guide, you must also install a web server. This guide will assume that you have completed the appropriate LAMP guide for your operating system. Additionally you will need to install a local MTA to send email if you do not have an MTA installed.
If you're running Debian or Ubuntu systems, ensure that your system's package repository is up to date, that all installed packages have been upgraded with the latest bug fixes and security patches with the following command sequence. Additionally, install all prerequisite packages by issuing these commands:
apt-get update apt-get upgrade apt-get install unzip libgv-php5
On CentOS and Fedora systems issue the following command to ensure your system's packages up to date, and that all required dependencies are installed:
rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm yum update yum install unzip graphviz graphiz-php
For the purpose of this guide we will assume that you have virtual hosting configured for the domain example.com with all publicly accessible resources located in the document root /srv/www/example.com/public_html/. Furthermore, in this document you will install Flyspray in this document root. Modify all of the instructions below to agree with the architecture of your deployment.
This document contains specific instructions for installing version 0.9.9.6 of Flyspray. Check the upstream to confirm that 0.9.9.6 is the most recent stable release of Flyspray. By installing the latest version you may be able to prevent falling victim to known vulnerabilities or bugs with older versions of the software. Issue the following sequence of commands to download, extract, move the Flyspray files to your web servers' document root, and properly configure file permissions:
mkdir -p /srv/www/example.com/src/ mkdir -p /srv/www/example.com/public_html/ cd /srv/www/example.com/public_html/ wget http://flyspray.org/flyspray-0.9.9.6.zip unzip flyspray-0.9.9.6.zip mv flyspray-0.9.9.6.zip /srv/www/example.com/src/ touch flyspray.conf.php chmod 777 flyspray.conf.php cache/ attachments/
Now visit http://example.com/ in your web browser, and follow the setup procedure provided by Flyspray's web based interface. When the setup process has completed, issue the following commands to remove the setup files and reset permissions:
rm -rf /srv/www/example.com/public_html/setup/ chmod 755 /srv/www/example.com/public_html/flyspray.conf.php
Congratulations! You have now successfully deployed Flyspray.
When running software compiled or installed directly from sources provided by upstream developers, you are responsible for monitoring updates, bug fixes, and security issues. After becoming aware of releases and potential issues, update your software to resolve flaws and prevent possible system compromise. Monitoring releases and maintaining up to date versions of all software is crucial for the security and integrity of a system.
Please monitor the following mailing lists and bug databases to ensure that you are aware of all updates to the software and can upgrade appropriately or apply patches and recompile as needed:
When upstream sources offer new releases, repeat the instructions for installing Flyspray software as needed. These practices are crucial for the ongoing security and functioning of your system.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This guide is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License.
Last edited by Sharon Campbell on Friday, October 4th, 2013 (r3776).