summaryrefslogtreecommitdiffstats
path: root/doc/INSTALL
blob: 035e97cab8bd5a0823ba47ffefff60fe026d150a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
== Redmine installation

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


== Requirements

* Ruby on Rails 1.2.5 or 2.0.1
* A database (see compatibility below)

Optional:
* SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
* RMagick (gantt export to png)

Supported databases:
* MySQL (tested with MySQL 5)
* PostgreSQL (tested with PostgreSQL 8.1)
* SQLite (tested with SQLite 3)


== Installation

1. Uncompress the program archive
   
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 db:migrate RAILS_ENV="production"
   It will create tables and an administrator account.

5. 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

6. Use default administrator account to log in:
   login: admin
   password: admin
   
7. Go to "Administration" to load the default configuration data (roles, 
   trackers, statuses, workflow) and adjust application settings


== 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 to this file.