Redmine

h1. Installing Redmine

{{>TOC}}

h2. Requirements

    * Ruby on Rails 2.0.2

    * A database (see compatibility below)

Optional:

    * SVN binaries (>= 1.3), for repository browsing (must be available in your PATH)

    * RMagick (Gantt export to a png image)

Supported databases:

    * MySQL (recommended)

    * PostgreSQL

    * SQLite (please read this: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails)

h2. Installation

1. [[Download]] and extract the archive or [[CheckingoutRedmine|checkout]] Redmine.

2. Create an empty database named @redmine@ for example.

For MySQL:

  create database redmine character set utf8;

3. Copy @config/database.yml.example@ to @config/database.yml@ and edit this file in order to configure your database settings for "production" environment.

Example for a MySQL database:

  production:

    adapter: mysql

    database: redmine

    host: localhost

    username: bduser

    password: bdpasswd

4. Create the database structure, by running the following command under the application root directory:

  rake db:migrate RAILS_ENV="production"

It will create tables and an administrator account.

5. Insert default configuration data in database, by running the following command:

  rake redmine:load_default_data RAILS_ENV="production"

This step is optional but *highly recommended*, as you can define your own configuration from scratch. It will load default roles, trackers, statuses, workflows and enumerations.

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. You can go to @Admin & Settings@ to modify application settings.

h2. SMTP server Configuration

In config/environment.rb, you can set parameters for your SMTP server:

    * config.action_mailer.smtp_settings: SMTP server configuration

    * config.action_mailer.perform_deliveries: set to false to disable mail delivering

Don't forget to restart the application after any change.

h2. Backups

Redmine backups should include:

* data (stored in your redmine database)

* attachments (stored in the @files@ directory of your Redmine install)

Here is a simple shell script that can be used for daily backups (assuming you're using a mysql database):

<pre>

# Database

/usr/bin/mysqldump -u <username> -p <password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz

# Attachments

rsync -a /path/to/redmine/files /path/to/backup/files

</pre>