== Redmine installation Redmine - project management software Copyright (C) 2006-2012 Jean-Philippe Lang http://www.redmine.org/ == Requirements * Ruby 1.8.7, 1.9.2 or 1.9.3 * RubyGems * Bundler >= 1.0.21 * A database: * MySQL (tested with MySQL 5.1) * PostgreSQL (tested with PostgreSQL 9.1) * SQLite3 (tested with SQLite 3.6) Optional: * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH) * ImageMagick (to enable Gantt export to png images) == Installation 1. Uncompress the program archive 2. Install the required gems by running: bundle install --without development test If ImageMagick is not installed on your system, you should skip the installation of the rmagick gem using: bundle install --without development test rmagick If you need to load some gems that are not required by Redmine core (eg. fcgi), you can create a file named Gemfile.local at the root of your redmine directory. It will be loaded automatically when running `bundle install`. 3. Create an empty utf8 encoded database: "redmine" for example 4. Configure the database parameters in config/database.yml for the "production" environment (default database is MySQL and ruby1.8) If you're running Redmine with MySQL and ruby1.9, replace the adapter name with `mysql2` 5. Generate a session store secret Redmine stores session data in cookies by default, which requires a secret to be generated. Under the application main directory run: rake generate_secret_token 6. Create the database structure Under the application main directory run: rake db:migrate RAILS_ENV="production" It will create all the tables and an administrator account. 7. 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. Assuming you run Redmine with a user named "redmine": sudo chown -R redmine:redmine files log tmp public/plugin_assets sudo chmod -R 755 files log tmp public/plugin_assets 8. Test the installation by running the WEBrick web server Under the main application directory run: ruby script/rails server -e production Once WEBrick has started, point your browser to http://localhost:3000/ You should now see the application welcome page. 9. Use the default administrator account to log in: login: admin password: admin Go to "Administration" to load the default configuration data (roles, trackers, statuses, workflow) and to adjust the application settings == SMTP server Configuration Copy config/configuration.yml.example to config/configuration.yml and edit this file to adjust your SMTP settings. Do not forget to restart the application after any change to this file. Please do not enter your SMTP settings in environment.rb. == 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