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