RedmineInstall » History » Revision 33
« Previous |
Revision 33/349
(diff)
| Next »
Jean-Philippe Lang, 2009-02-23 23:46
force webrick
Installing Redmine¶
- Table of contents
- Installing Redmine
Requirements¶
Operating system¶
Redmine should run on most Unix, Linux, Mac and Windows systems as long as ruby is available on this platform.
Ruby & Ruby on Rails¶
The required Ruby and Ruby on Rails versions for a given Redmine version is:
Redmine version | Supported Ruby versions | Required Rails version |
---|---|---|
current trunk | ruby 1.8.6, 1.8.7 | Rails 2.2.2 |
trunk before r2493 | ruby 1.8.6, 1.8.7 | Rails 2.1.2 |
0.8.x | ruby 1.8.6, 1.8.7 | Rails 2.1.2 |
0.7.x | ruby 1.8.6 | 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.2.2
Notes:
- RubyGems 1.3.1 is required
- Rake 0.8.3 is required
Database¶
- MySQL 4.1 or higher (recommended)
- PostgreSQL 8
- SQLite 3
If you're using a MySQL database, make sure to install the C bindings that dramatically improve performance. You can get them by running gem install mysql
.
Optional components¶
- SCM binaries (eg.
svn
), for repository browsing (must be available in your PATH). See RedmineRepositories for SCM compatibility and requirements. - RMagick (to enable Gantt export to png image)
Installation¶
1. Download and extract the archive or 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:
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"
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. Generate a session store secret (r2493 and higher only)
Redmine stores session data in cookies by default, which requires a secret to be generated. This can be done by running:
rake config/initializers/session_store.rb
7. 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:
mkdir tmp public/plugin_assets 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 WEBrick web server:
ruby script/server webrick -e production
Once WEBrick has started, point your browser to http://localhost:3000/. You should now see the application welcome page.
9. Use default administrator account to log in:
- login: admin
- password: admin
You can go to Admin & Settings
to modify application settings.
SMTP server Configuration¶
0.8.x releases¶
Copy config/email.yml.example
to config/email.yml
and edit this file to adjust your SMTP settings.
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.
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):
# 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
Updated by Jean-Philippe Lang almost 16 years ago · 33 revisions locked