Flyspray

This material is work-in-progress ... Do not follow instructions here until this notice is removed. (Last edited by Sertonix on 17 Nov 2023.)

Installing Flyspray

apk add flyspray

Database support

Flyspray supports only MySQL and PostgreSQL. Here we cover MySQL installation, but the steps are basically the same with PostgreSQL.

Install Database support

apk add flyspray-mysqli

Notice that even though flyspray-mysql package is available, if you install it Flyspray will report that the function library is deprecated, that is quite annoying.

Is better to use mysqli package.

Now before we continue we need to create the database.

create database flyspray; create user 'flyspraydbuser'@'localhost' identified by 'my_password'; grant all privileges on flyspray.* to 'flyspraydbuser'@'localhost';

If you need mysql client, you can install it like this:

apk add mysql-client

You can of course also use a tool like phpmyadmin to create the database and setup the user.

Setup Lighttpd

Now our database is ready, we need to install and configure Lighttpd, with PHP support.

apk add lighttpd

Now, you should enable PHP/FastCGI support modifying Lighttpd configuration.

You can find it in /etc/lighttpd.

vi /etc/lighttpd/lighttpd.conf

 ... 
 include "mod_fastcgi.conf"
 ...

rc-service lighttpd start

If your server does not run, you can find information in /var/log/lighttpd. If that does not provide a clue you can also run Lighttpd in foreground. It should display some more debug information.

rc-service lighttpd stop lighttpd -f /etc/lighttpd/lighttpd.conf -D

Flyspray configuration

Now that everything is ready, you need to make Flyspray visible to the webserver. For doing that, create a symlink from /usr/share/webapps/flyspray (that is the default location where flyspray is installed) to /var/www/localhost/htdocs. This is the document root directory of lighttpd server. If you use another webserver, check what is the document root and put the symlink there.

ln -s /usr/share/webapps/flyspray /var/www/localhost/htdocs/flyspray

Flyspray needs permission to write on flyspray.conf.php that is in the root directory.

touch /usr/share/webapps/flyspray/flyspray.conf chmod 775 /usr/share/webapps/flyspray/flyspray.conf.php chgrp www-data /usr/share/webapps/flyspray/flyspray.conf.php

That's all.

Open your browser to http://$FLYSPRAY_SERVER/flyspray and follow the instruction.