##// END OF EJS Templates
jro_apps » redmine
RSS
Merged r13471....
Jean-Philippe Lang -
r13091:05c2cea56fbe
parent child
Show More
Side by Side Unified
Context file:
r13091:05c2cea56fbe Loading diff...:

The requested changes are too big and content was truncated. Show full diff

Show file before | Show file after | Hide comments
1 NO CONTENT: modified file
The requested commit or file is too big and content was truncated. Show full diff
Show file before | Show file after | Hide comments
@@ -1,106 +1,106
1 1 == Redmine installation
2 2
3 3 Redmine - project management software
4 4 Copyright (C) 2006-2014 Jean-Philippe Lang
5 5 http://www.redmine.org/
6 6
7 7
8 8 == Requirements
9 9
10 * Ruby 1.8.7, 1.9.2, 1.9.3 or 2.0.0
10 * Ruby 1.8.7, 1.9.2, 1.9.3, 2.0 or 2.1
11 11 * RubyGems
12 12 * Bundler >= 1.0.21
13 13
14 14 * A database:
15 15 * MySQL (tested with MySQL 5.1)
16 16 * PostgreSQL (tested with PostgreSQL 9.1)
17 17 * SQLite3 (tested with SQLite 3.7)
18 18 * SQLServer (tested with SQLServer 2012)
19 19
20 20 Optional:
21 21 * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH)
22 22 * ImageMagick (to enable Gantt export to png images)
23 23
24 24 == Installation
25 25
26 26 1. Uncompress the program archive
27 27
28 28 2. Create an empty utf8 encoded database: "redmine" for example
29 29
30 30 3. Configure the database parameters in config/database.yml
31 31 for the "production" environment (default database is MySQL and ruby1.9)
32 32
33 33 If you're running Redmine with MySQL and ruby1.8, replace the adapter name
34 34 with `mysql`
35 35
36 36 4. Install the required gems by running:
37 37 bundle install --without development test
38 38
39 39 If ImageMagick is not installed on your system, you should skip the installation
40 40 of the rmagick gem using:
41 41 bundle install --without development test rmagick
42 42
43 43 Only the gems that are needed by the adapters you've specified in your database
44 44 configuration file are actually installed (eg. if your config/database.yml
45 45 uses the 'mysql2' adapter, then only the mysql2 gem will be installed). Don't
46 46 forget to re-run `bundle install` when you change config/database.yml for using
47 47 other database adapters.
48 48
49 49 If you need to load some gems that are not required by Redmine core (eg. fcgi),
50 50 you can create a file named Gemfile.local at the root of your redmine directory.
51 51 It will be loaded automatically when running `bundle install`.
52 52
53 53 5. Generate a session store secret
54 54
55 55 Redmine stores session data in cookies by default, which requires
56 56 a secret to be generated. Under the application main directory run:
57 57 rake generate_secret_token
58 58
59 59 6. Create the database structure
60 60
61 61 Under the application main directory run:
62 62 rake db:migrate RAILS_ENV="production"
63 63
64 64 It will create all the tables and an administrator account.
65 65
66 66 7. Setting up permissions (Windows users have to skip this section)
67 67
68 68 The user who runs Redmine must have write permission on the following
69 69 subdirectories: files, log, tmp & public/plugin_assets.
70 70
71 71 Assuming you run Redmine with a user named "redmine":
72 72 sudo chown -R redmine:redmine files log tmp public/plugin_assets
73 73 sudo chmod -R 755 files log tmp public/plugin_assets
74 74
75 75 8. Test the installation by running the WEBrick web server
76 76
77 77 Under the main application directory run:
78 78 ruby script/rails server -e production
79 79
80 80 Once WEBrick has started, point your browser to http://localhost:3000/
81 81 You should now see the application welcome page.
82 82
83 83 9. Use the default administrator account to log in:
84 84 login: admin
85 85 password: admin
86 86
87 87 Go to "Administration" to load the default configuration data (roles,
88 88 trackers, statuses, workflow) and to adjust the application settings
89 89
90 90 == SMTP server Configuration
91 91
92 92 Copy config/configuration.yml.example to config/configuration.yml and
93 93 edit this file to adjust your SMTP settings.
94 94 Do not forget to restart the application after any change to this file.
95 95
96 96 Please do not enter your SMTP settings in environment.rb.
97 97
98 98 == References
99 99
100 100 * http://www.redmine.org/wiki/redmine/RedmineInstall
101 101 * http://www.redmine.org/wiki/redmine/EmailConfiguration
102 102 * http://www.redmine.org/wiki/redmine/RedmineSettings
103 103 * http://www.redmine.org/wiki/redmine/RedmineRepositories
104 104 * http://www.redmine.org/wiki/redmine/RedmineReceivingEmails
105 105 * http://www.redmine.org/wiki/redmine/RedmineReminderEmails
106 106 * http://www.redmine.org/wiki/redmine/RedmineLDAP
General Comments 0
You need to be logged in to leave comments. Login now