openproject/doc/INSTALL

== redMine installation

redMine - project management software
Copyright (C) 2006-2007  Jean-Philippe Lang
http://redmine.rubyforge.org/


== Requirements

* Ruby on Rails 1.1
* Iconv
* A database (see compatibility below)

Optional:
* RedCloth (to enable textile formatting)

Supported databases:
* MySQL (tested with MySQL 5)
* PostgreSQL (tested with PostgreSQL 8.1)
* Oracle (tested with Oracle 10g)
* SQL Server (tested with SQL Server 2005)
* SQLite (tested with SQLite 3)


== Installation

1. Uncompress program archive:
   tar zxvf <filename>
   
2. Create an empty database: "redmine" for example

3. Configure database parameters in config/database.yml
   for "production" environment (default database is MySQL)

4. Create the database structure. Under the application main directory:
   rake migrate RAILS_ENV="production"
   It will create tables and an administrator account.

5. Insert default configuration data in database:
   rake load_default_data RAILS_ENV="production"
   It will load default roles, trackers, statuses, workflows and enumerations.
   This step is optional (but recommended), as you can define your
   own configuration from sratch.

6. Test the installation by running WEBrick web server:
   ruby script/server -e production   
  
   Once WEBrick has started, point your browser to http://localhost:3000/
   You should now see the application welcome page

7. Use default administrator account to log in:
   login: admin
   password: admin

8. Setup Apache or Lighttpd with fastcgi for best performance.


== Configuration

A sample configuration file is provided: "config/config_custom.example.rb"
Rename it to config_custom.rb and set your parameters.
Don't forget to restart the application after any change.

In config/environment.rb, you can set parameters for your SMTP server:
config.action_mailer.server_settings: SMTP server configuration
config.action_mailer.perform_deliveries: set to false to disable mail delivering


== Upgrading

See UPGRADING