RedmineInstall » History » Revision 4
Revision 3 (Jean-Philippe Lang, 2007-10-12 13:19) → Revision 4/345 (Jean-Philippe Lang, 2007-10-14 10:21)
h1. Installing Redmine
{{>TOC}}
h2. Requirements
* Ruby on Rails 1.2.2 or 1.2.3
* 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
h2. Installation
1. [[Download]] and extract the archive or checkout Redmine.
2. Create an empty database: "redmine" for example
3. Copy @config/database.example.yml@ 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"
It will load default roles, trackers, statuses, workflows and enumerations.
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.