This tutorial will guide you through the process of installing Redmine, a flexible project management web application written in Ruby on Rails, on a Ruby Simple Hosting instance.

Redmine is open source and released under the terms of the GNU General Public License v2 (GPL).

Start by downloading the latest version of Redmine (version 2.5.1, at the time of this writing, in our example):

$ wget http://www.redmine.org/releases/redmine-2.5.1.tar.gz
$ tar -xzvf redmine-2.5.1.tar.gz
$ mv redmine-2.5.1 redmine
$ rm redmine-2.5.1.tar.gz
$ cd redmine

Remove the following lines from the file .gitignore:

/config/database.yml
/config/initializers/session_store.rb
/config/initializers/secret_token.rb
/public/plugin_assets
/Gemfile.lock
/Gemfile.local
/db/schema.rb

$ cp config/database.yml.example config/database.yml

Configure the database:

For MySQL:

--
file : config/database.yml
--

production:
  adapter: mysql2
  database: redmine
  socket: /srv/run/mysqld/mysqld.sock
  username: root
  password: ""
  encoding: utf8
  pool: 5

For PostgreSQL:

--
file: config/database.yml
--

[...]
production:
  adapter: postgresql
  template: template0
  database: redmine
  host: localhost
  port: 5432
  username: hosting-db
  password: 
  encoding: unicode
  pool: 5
[...]

Next, install the necessary dependencies and generate the Gemfile.lock file using Bundler:

 $ bundle install 

or, without Rmagick:

 $ bundle install --without rmagick 

Next, generate a secret token:

$ bundle exec rake generate_secret_token

Initialize the repo and push the code to the instance:

$ git init  
$ git add .
$ git commit -am 'Initial install'
$ git remote add gandi git+ssh://INSTANCE_ID@git.DC_ID.gpaas.net/default.git
$ git push gandi master

Deployment is performed by running the following command:

$ ssh LOGIN@git.DC_ID.gpaas.net 'deploy default.git'

To finish, activate the SSH console of the instance, then connect via SSH and run the following command to initialize the database:

$ cd web/vhosts/default/
$ bundle exec rake db:setup

It's often useful to run an extra command to create certain default Redmine options, such as the interface language.

Still in the web/vhosts/default/ directory, run:

$ bundle exec rake redmine:load_default_data

Choose “en” for English, “fr” for French, or “es” for Spanish.

To access your Redmine installation, browse to the default URL that is displayed on the instance control panel in your Gandi account.

The default login credentials are as follows:

• Login: admin
• Password: admin

You can now use your Redmine installation to manage your projects!