Flyspray
This material is work-in-progress ... Do not follow instructions here until this notice is removed. |
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.