Project

General

Profile

RedmineInstall » History » Version 2

Jean-Philippe Lang, 2007-10-11 19:36

1 1 Jean-Philippe Lang
h1. Installing Redmine
2
3
{{>TOC}}
4
5
h2. Requirements
6
7
    * Ruby on Rails 1.2.2 or 1.2.3
8
    * A database (see compatibility below)
9
10
Optional:
11
12
    * SVN binaries (>= 1.3), for repository browsing (must be available in your PATH)
13
    * RMagick (Gantt export to a png image)
14
15
Supported databases:
16
17
    * MySQL (recommended)
18
    * PostgreSQL
19
    * SQLite
20
21
h2. Installation
22
23
1. [[Download]] and extract the archive or checkout Redmine.
24
25
2. Create an empty database: "redmine" for example
26
27 2 Jean-Philippe Lang
3. Copy @config/database.example.yml@ to @config/database.yml@ and edit this file in order to configure your database settings for "production" environment (default database is MySQL).
28 1 Jean-Philippe Lang
29
4. Create the database structure. Under the application root directory:
30
31
  rake db:migrate RAILS_ENV="production"
32
33
It will create tables and an administrator account.
34
35
5. Insert default configuration data in database:
36
37
  rake redmine:load_default_data RAILS_ENV="production"
38
39 2 Jean-Philippe Lang
It will load default roles, trackers, statuses, workflows and enumerations.
40
41
This step is optional but *highly recommended*, as you can define your own configuration from scratch.
42 1 Jean-Philippe Lang
43
6. Test the installation by running WEBrick web server:
44
45
  ruby script/server -e production
46
47
Once WEBrick has started, point your browser to http://localhost:3000/. You should now see the application welcome page.
48
49
7. Use default administrator account to log in:
50
51
    * login: admin
52
    * password: admin
53
54
8. You can go to “Admin → Settings” to modify application settings.
55
56
h2. SMTP server Configuration
57
58
In config/environment.rb, you can set parameters for your SMTP server:
59
60
    * config.action_mailer.smtp_settings: SMTP server configuration
61
    * config.action_mailer.perform_deliveries: set to false to disable mail delivering
62
63
Don’t forget to restart the application after any change.