====== Installing Flyspray ======
This document describes the installation process for setting up **Flyspray version 0.9.9**. When reading this guide and performing the following install steps, please go in order; Some of the later steps require that the previous steps have been completed, otherwise the installation will fail.\\
\\




===== Preparing for install =====
  * Install PHP, MySQL or PostgreSQL, and a web server (like Apache). The latest versions of each should work nicely.
  * For MySQL installations, it's a good idea to install the MySQL Administrator and MySQL Query Browser. Both can be found here: http://dev.mysql.com/downloads/gui-tools/5.0.html
  * A good tutorial on how to get Apache, PHP, and MySQL working together is here: http://www.tanguay.at/installPhp5.php5?step=1
  * In the php.ini file, make sure that the extension php_mysql.dll is uncommented. The tutorial neglects to include this step.
  * A good tutorial on how to get PHP & MySQL installed and working with IIS is here: http://www.builderau.com.au/program/mysql/print.htm?TYPE=story&AT=339271632-339028784t-320002018c
  * Grab the latest release from the [[:download]] page or perform an SVN checkout of the **0.9.9** stable branch in our SVN repository (highly recommended).
  * Unpack the compressed package into a directory where your webserver can reach it.
  * Remove the file flyspray.conf.php
  * In the case that the database user you use for your Flyspray installation cannot create a database on its own, create a database for Flyspray to use.
<code>
# mysql -u root -p
  > CREATE DATABASE flyspray DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci; 
  > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER,CREATE TEMPORARY TABLES ON flyspray.*
          TO flysprayuser@localhost IDENTIFIED BY 'yourpassword'; 
  > quit 
  # mysqladmin -u root -p reload

</code>
  * Or, create a PostgreSQL database for Flyspray to use:
<code>su;
su postgres;
createuser -SDRP flyspray;
createdb -E UNICODE -O flyspray flyspray;</code>
  * Make sure the attachments/ and cache/ directory is writeable by the webserver.





===== Installation =====
  * Point your browser to %%http://yourserver/flyspray/setup/%% and follow along with Flyspray Setup.
  * When Setup completes, you will be automatically logged-in, and taken to your user profile where you can change  details such as your Real Name.
  * A message will tell you to remove the directory %%http://yourserver/flyspray/setup/%%
If you would like to enable support for the **local** [[dependencies#task_dependency_graphs|Task Dependency Graphs]] feature, an optional additional package can be installed to enable it. Most operating systems have a package available for the free [[http://www.graphviz.org/|Graphviz]] package, either in an OS-specific package or by download direct from the Graphviz site. After installing Graphviz, add the path to the dot executable to flyspray.conf.php.

===== After installation =====
  * **Enable the reminder daemon** if needed (for reminders, Jabber notifications and background sending of notifications ((since 1.0)) ), by setting //reminder_daemon//=1 in flyspray.conf.php
  * Click the 'Manage Project' link to set up your project preferences, user groups and lists.
  * Close the sample task, and start adding your own, real tasks.
  * If you need help, read the [[manual:toc|documentation]], [[:faq]], and [[:support]] pages.
  * If you want to enable dokuwiki syntax, edit flyspray.conf.php. Change the operand of the **syntax_plugin** statement to "dokuwiki".