Redmine
Contents
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).
Requirements
You may want to check the upstreamRedmine requirements, although the default Debian packages should work.
Installation
Redmine database and application
1. Install your database:
# apt install postgresql # or default-mysql-server
2. Install Redmine with support for your database of choice (if you install the base redmine package instead of selecting one of the database-specific packages, it will select redmine-sqlite by default):
# 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 upgrading (see below), using an external database or want to otherwise manually configure this.
Note: dbconfig will assume unix socket access to the database
3. Configure the web server
apt install apache2 libapache2-mod-passenger
To use your domain for Redmine only (ie. http://domain.com/):
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. http://domain.com/redmine):
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:
ServerName exampledomain.com
ServerAdmin admin@exampledomain.comNext:
# 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
TLS certificate
Assuming your Redmine server is exposed to Internet and it's configured with DNS entries, FQDN etc., you should obtain a TLS certificate, e.g. using LetsEncrypt.
Installing plugins
Plugins will be loaded from /var/lib/redmine/instances/$REDMINE_INSTANCE/plugins/. If this directory does not exist, loading will fall back to the global plugins directory at /usr/share/redmine/plugins/. The /var/lib/redmine/instances/$REDMINE_INSTANCE/plugins/ directory is automatically created each time Redmine is upgraded. To enable a plugin for an instance it can be symlinked from the global plugins directory.
The Debian Redmine 6.x packages significantly change how plugins and multitenancy are handled. If you upgrade from a previous version and have Debian Redmine plugin packages installed, you will probably need to symlink the plugins you want to the instance.
After installing or symlinking plugins, restart Redmine to activate them. For example, on Apache, run the following command:
sudo service apache2 reload
The following help command provides more information:
/usr/share/redmine/bin/redmine-instances help
Additional documentation
Further useful information is available in /usr/share/doc/redmine/README.Debian.gz (the current version of this file is also available in the Salsa repository).