Redmine

Jessie (Debian 8)

Quick installation howto

1. Install your database, e.g. postgresql (or don't, if you want to use sqlite)

apt install postgresql # or mysql-server

2. Install Redmine with support for your database of choice

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

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

3. Configure the web server

apt install apache2 libapache2-mod-passenger
cp /usr/share/doc/redmine/examples/apache2-passenger-host.conf /etc/apache2/sites-available/redmine.conf
edit /etc/apache2/sites-available/redmine.conf
a2enmod passenger
a2ensite redmine.conf
service apache2 reload

To use the same domain shared with other applications, base your config on /usr/share/doc/redmine/examples/apache2-passenger-alias.conf instead.

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

username: admin
password: admin

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:

• The application logs are located under /var/log/redmine/${instance}/ (instead of /path/to/redmine/log)

• The database configuration is located at /etc/redmine/${instance}/database.yml (instead of /path/to/redmine/config/database.yml)

• File attachments are located under /var/lib/redmine/${instance}/files

• Plugins should be placed under /usr/share/redmine/plugins. The folder doesn't exist by default and must be created. Don't use /usr/share/redmine/lib/plugins as this result to routing error in the application.

CategorySystemAdministration CategorySystemAdministration