We do not recommend that you setup new ChiliProject instances and
we urge all existing users to migrate their data to a maintained
system, e.g. Redmine. We will
provide a migration script later. In the meantime, you can use the
instructions by
Christian Daehn.

Specific guides exist for [[Installation_on_Ubuntu_10_10|Ubuntu]], [[Installation on Debian Squeeze|Debian]], [[Installation_on_OpenSUSE_11_3|OpenSUSE]], and [[Installation on CentOS 5|CentOS]]. If you are using Gentoo, you might be interested in this "Gentoo bug":https://bugs.gentoo.org/show_bug.cgi?id=374789 or "Overlay":http://groeper-berlin.de/Gentoo/, they both provide a (the same) ebuild for ChiliProject.

It is recommended that you use the latest @stable@ release of ChiliProject for production deployments. Although we work hard on keeping the whole [[ChiliProject Repository|code base]] stable, the @master@ and @unstable@ branches might break from time to time, so use them only if you are willing to engage very closely with the inner workings of ChiliProject.

# Copy @config/configuration.yml.example@ to @config/configuration.yml@ and edit this file for your system's environment. You can check the comments in the file and on [[Configuration File]] for all of the options.

</pre>This step is optional but *highly recommended*. It will load default roles, trackers, statuses, workflows and enumerations. If you choose to skip this step, you can later define your own configuration from scratch.

The user who runs ChiliProject must have write permission on the following sub-directories: @files@, @log@, @tmp@, and @public/plugin_assets@. So assuming you run ChiliProject with a user called @chiliproject@ you need to setup the following permissions: <pre>

%(smallimportant)Webrick is not suitable for normal use, please only use Webrick for testing that the installation up to this point is functional. It is not recommended to use Webrick for anything other than development or testing. Use one of the many other guides in this wiki to setup ChiliProject with a real application server like "Phusion Passenger (mod_rails) ":http://www.modrails.com/, "Unicorn":http://unicorn.bogomips.org/, or "Thin":http://code.macournoyer.com/thin/.%

# You can now go to %(button)Administration% to *modify the basic application settings*. Have a look at the [[Using ChiliProject|user guide]] for information on how to configure your new ChiliProject server.