RedmineInstall » History » Revision 23
Revision 22 (Jean-Philippe Lang, 2008-12-07 12:45) → Revision 23/345 (Jean-Philippe Lang, 2008-12-27 16:15)
h1. Installing Redmine {{>TOC}} h2. Requirements * Ruby & Ruby on Rails: |_. Redmine version|_. Rails version required| |trunk|Rails 2.1.2| |0.8.x|Rails 2.1.2| |0.7.x|Rails 2.0.2| Official releases include the appropriate Rails version in their @vendor@ directory. So no particular action is needed. If you checkout the source from the Redmine repository, you can install a specific Rails version on your machine by running: gem install rails -v=2.1.2 * A database: * MySQL 4.1 or higher (recommended) * PostgreSQL 8 * SQLite 3 (please read this: http://weblog.rubyonrails.org/2007/1/29/using-sqlite3-with-rails) * Optional: * SVN binaries (>= 1.3), for repository browsing (must be available in your PATH) * RMagick (Gantt export to a png image) Notes: * Note that Rails has some compatibility issues with ruby 1.8.7. *The supported ruby version is 1.8.6*. * *Rails 2.2.x is not supported* for now. h2. Installation 1. [[Download]] and extract the archive or [[CheckingoutRedmine|checkout]] Redmine. 2. Create an empty database named @redmine@ for example. For MySQL: create database redmine character set utf8; 3. Copy @config/database.yml.example@ to @config/database.yml@ and edit this file in order to configure your database settings for "production" environment. Example for a MySQL database: <pre> production: adapter: mysql database: redmine host: localhost username: bduser password: bdpasswd </pre> 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" 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. Setting up permissions NB: _Windows users have to skip this section._ The user who runs Redmine must have write permission on the following subdirectories: @files@, @log@, @tmp@ (create the last one if not present). Assuming you run Redmine with a @redmine@ user: <pre> mkdir tmp sudo chown -R redmine:redmine files log tmp sudo chmod -R 755 files log tmp </pre> 7. 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. 8. Use default administrator account to log in: * login: admin * password: admin You can go to @Admin & Settings@ to modify application settings. h2. SMTP server Configuration h3. 0.8.x releases Copy @config/email.yml.example@ to @config/email.yml@ and edit this file to adjust your SMTP settings. h3. 0.7.x releases 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. h2. Backups Redmine backups should include: * data (stored in your redmine database) * attachments (stored in the @files@ directory of your Redmine install) Here is a simple shell script that can be used for daily backups (assuming you're using a mysql database): <pre> # Database /usr/bin/mysqldump -u <username> -p <password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz # Attachments rsync -a /path/to/redmine/files /path/to/backup/files </pre>