INSTALL 2.92 KB
Newer Older
1 2 3
== Redmine installation

Redmine - project management software
Jean-Philippe Lang's avatar
Jean-Philippe Lang committed
4
Copyright (C) 2006-2010  Jean-Philippe Lang
5 6 7 8 9
http://www.redmine.org/


== Requirements

10 11
* Ruby 1.8.6 or 1.8.7

12 13
* RubyGems 1.3.1

14 15
* Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with
  the appropriate Rails version)
16

17
* Rack 1.0.1 gem
18

19
* Rake 0.8.3 gem
20

21
* I18n 0.4.2 gem
22

23 24 25 26
* A database:
  * MySQL (tested with MySQL 5)
  * PostgreSQL (tested with PostgreSQL 8.1)
  * SQLite (tested with SQLite 3)
27 28

Optional:
29 30 31
* SCM binaries (e.g. svn), for repository browsing (must be available in PATH)
* RMagick (to enable Gantt export to png images)
* Ruby OpenID Library >= version 2 (to enable OpenID support)
32 33 34 35

== Installation

1. Uncompress the program archive
36

37 38
2. Create an empty database: "redmine" for example

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

42
4. Generate a session store secret
43
   
44
   Redmine stores session data in cookies by default, which requires
45 46 47 48
   a secret to be generated. Under the application main directory run:
     rake generate_session_store

5. Create the database structure
49
   
50 51
   Under the application main directory run:
     rake db:migrate RAILS_ENV="production"
52
   
53
   It will create all the tables and an administrator account.
54

55 56 57 58 59 60 61 62 63 64
6. Setting up permissions (Windows users have to skip this section)
   
   The user who runs Redmine must have write permission on the following
   subdirectories: files, log, tmp & public/plugin_assets (create the last
   two if they are not yet present).
   
   Assuming you run Redmine with a user named "redmine":
     mkdir tmp public/plugin_assets
     sudo chown -R redmine:redmine files log tmp public/plugin_assets
     sudo chmod -R 755 files log tmp public/plugin_assets
65

66 67 68 69 70
7. Test the installation by running the WEBrick web server
   
   Under the main application directory run:
     ruby script/server -e production
   
71
   Once WEBrick has started, point your browser to http://localhost:3000/
72
   You should now see the application welcome page.
73

74
8. Use the default administrator account to log in:
75 76 77
   login: admin
   password: admin
   
78 79
   Go to "Administration" to load the default configuration data (roles,
   trackers, statuses, workflow) and to adjust the application settings
80

81
== SMTP server Configuration
82

83 84
Copy config/email.yml.example to config/email.yml and edit this file
to adjust your SMTP settings.
85
Do not forget to restart the application after any change to this file.
86 87

Please do not enter your SMTP settings in environment.rb.
88 89 90 91 92 93 94 95 96 97

== References

* http://www.redmine.org/wiki/redmine/RedmineInstall
* http://www.redmine.org/wiki/redmine/EmailConfiguration
* http://www.redmine.org/wiki/redmine/RedmineSettings
* http://www.redmine.org/wiki/redmine/RedmineRepositories
* http://www.redmine.org/wiki/redmine/RedmineReceivingEmails
* http://www.redmine.org/wiki/redmine/RedmineReminderEmails
* http://www.redmine.org/wiki/redmine/RedmineLDAP