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).
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-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 a2dissite 000-default 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.
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
Stretch (Debian 9)
Update for Debian 9.3
I installed Redmine with mariadb according to the Debian 8 section above without any problems (February 2018)
it is advised (current state August 2017) to use psql instead of mariadb as these package installations worked just like the commands from Debian 9 without any problem - see below
mariadb problems
instead of mysql debian 9 supports mariadb which could according to [1] result in incompabilities -> maybe this could be the cause for this error:
error: template infile /usr/share/redmine/templates/database-.yml.template does not exist
- had problems with db-config, created db-User and db manually
- copied template db file and modified it according to db/dbuser:
cp database-mysql.yml.template /etc/redmine/default/database.yml
- had to reinstall redmine again due to broken package status but encountered different error:
ActiveRecord::StatementInvalid: Mysql2::Error: Specified key was too long; max key length is 767 bytes: CREATE INDEX wiki_pages_wiki_id_title ON wiki_pages (wiki_id, title)
I was not able to solve this problem although I tried changing the ruby file and give a different limit, inspired by [2]
[1] http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Requirements
[2] https://stackoverflow.com/questions/10931307/ruby-on-rails-rake-schema-max-key-length-is-767-bytes
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.
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/ </Location> <Directory /your_redmine/public> Require all granted Allow from all AllowOverride all RailsBaseURI /redmine RailsEnv production Options -MultiViews </Directory>
# a2enconf redmine # systemctl reload apache2