Install Redmine on Ubuntu Oneiric with Passenger (aka mod_rails)

Submitted by jfhovinne on Tue, 11/10/2011 - 12:00

"Redmine is a flexible project management web application. Written using Ruby on Rails framework, it is cross-platform and cross-database."

To install Redmine on Ubuntu Oneiric with Apache, Passenger and MySQL, simply follow the following procedure:

$ sudo aptitude install redmine redmine-mysql mysql-server mysql-client apache2 libapache2-mod-passenger

Configure the virtual host:

$ sudo vi /etc/apache2/sites-available/yourhostname.example.com

<VirtualHost *:80>
        ServerName yourhostname.example.com
        RailsEnv production
        PassengerAppRoot /var/lib/redmine/default/passenger
        SetEnv X_DEBIAN_SITEID "default"
        Alias "/plugin_assets/" /var/cache/redmine/default/plugin_assets/
        DocumentRoot /usr/share/redmine/public
        <Directory "/usr/share/redmine/public">
                Order allow,deny
                Allow from all
        </Directory>
</VirtualHost>

$ sudo a2ensite yourhostname.example.com
$ sudo service apache2 reload

If you get stuck with Apache not interpreting the dispatcher, it means you probably miss the PassengerAppRoot symlink:

$ sudo ln -s /usr/share/redmine /var/lib/redmine/default/passenger

In order to configure your Redmine instance to send emails through your MTA (e.g. Postfix):

$ sudo vi /etc/redmine/default/email.yml

production:
  delivery_method: :sendmail
#  smtp_settings:
#    address: "localhost"
#    port: 25

Restart Apache; that's all.

Default administrative account is 'admin' with password 'admin'.

You should perhaps update this with a more secure password.

Default Redmine instance configuration files are located in /etc/redmine/default

More examples in /usr/share/doc/redmine/examples

Tags: