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

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


Check the Redmine requirements carefuly, specially if you won't be using PostgreSQL. A few MariaDB and MySQL issues remain open.


Redmine database and application

This was tested in Debian Stretch (9).

1. Install your database:

apt install postgresql # or mysql-server

2. Install Redmine with support for your database of choice

apt install redmine-pgsql # or redmine-mysql, or redmine-sqlite

This will also install all required dependencies including Ruby libraries, etc.

There will be one or more prompts asking to confirm database configuration via dbconfig-common. The default Yes should be OK unless you are using an external database or want to otherwise manually configure this.

3. Configure the web server

apt install apache2 libapache2-mod-passenger

To use your domain for Redmine only (ie.

cp /usr/share/doc/redmine/examples/apache2-passenger-host.conf /etc/apache2/sites-available/redmine.conf

To use the same domain shared with other applications (ie.

cp /usr/share/doc/redmine/examples/apache2-passenger-alias.conf /etc/apache2/sites-available/redmine.conf

Edit your configuration file to add your domain name and sysadmin contact information:

edit /etc/apache2/sites-available/redmine.conf

For example:



a2enmod passenger
a2ensite redmine.conf
a2dissite 000-default
service apache2 reload

Alternatively, to use the same domain but a different port, base your config on apache2-passenger-host.conf, then edit apache2.conf to also Listen to <port> and redmine.conf accordingly. In this case disabling 000-default is not required.

4. Log into Redmine at http://<ip>/ with the following default admin account:

username: admin
password: admin

SSL certificate

  1. Add the Debian Backports repository

  2. Follow instructions at the Certbot documentation

Differences from upstream Redmine

The Debian redmine package contains a few patches to support running multiple Redmine instances using a single codebase. You manage your instances by using dpkg-reconfigure redmine. This multi-instance support makes some things appear in places that are different from when you are using the upstream redmine:

Buster (Debian 10)

Apache 2.4.29

Create /etc/apache2/conf-available/redmine.conf

Example configuration:

Alias /redmine /your_redmine/public
<Location /redmine>
     PassengerBaseURI /redmine
     PassengerAppRoot /your_redmine/
<Directory /your_redmine/public>
    Require all granted
    Allow from all
    AllowOverride all
    RailsBaseURI /redmine
    RailsEnv production
    Options -MultiViews

# a2enconf redmine
# systemctl reload apache2

CategorySystemAdministration CategorySystemAdministration