Redmine unter Ubuntu 20.04 installieren

Wer ein leistungsstarkes Ticket- oder Projektmanagementsystem sucht, findet mit Redmine eventuell die perfekte Lösung. Auch ich verwende Redmine für Nocksoft. Da sich die manuelle Installation als nicht ganz einfach erweist, soll diese Anleitung es auch Einsteigern ermöglichen Redmine unter Ubuntu zu installieren. Die offizielle Anleitung ist hier zu finden und ebenfalls lesenswert.

Bereits mein alter Artikel Redmine unter Ubuntu 16.04 installieren ist auf großen Zuspruch gestoßen. Von daher ist es mit der neuen Ubuntu LTS-Version eine gute Gelegenheit diese Anleitung einmal zu aktualisieren.

Installation des Betriebssystems

Bei der Installation des Betriebssystems ist auf nicht viel zu achten. Ich verwende für diese Anleitung einen frisch installierten Ubuntu Server. Lediglich den SSH-Server habe ich bei der Installation mitinstalliert, um den Server später per PuTTY o.ä. administrieren zu können.

Nach der Grundinstallation nehme ich noch einige Einstellungen vor. In meiner Installation ist die Zeitzone nicht korrekt gesetzt. Das hole ich nach:

sudo unlink /etc/localtime
sudo ln -s /usr/share/zoneinfo/Europe/Berlin /etc/localtime

Anschließend installiere ich noch sämtliche zur Verfügung stehenden Updates:

sudo apt update && sudo apt upgrade -y

Apache und MySQL installieren

Redmine benötigt einen Webserver und eine Datenbank. Ich verwende standardmäßig Apache und MySQL. Für die Installation verwende ich folgenden Befehl:

sudo apt install apache2 mysql-server

Datenbank anlegen

Um eine neue Datenbank für Redmine anzulegen, muss sich zunächst an der MySQL-Shell angemeldet werden:

sudo mysql

Mit den folgenden Befehlen erstelle ich die Datenbank redmine und einen Benutzer redmine, der Berechtigungen hat, um sich an der neuen Datenbank anzumelden (password ist natürlich mit dem gewünschten Passwort für den neuen MySQL-Benutzer redmine zu ersetzen):

CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

Redmine herunterladen und entpacken

Im nächsten Schritt kann Redmine heruntergeladen und installiert werden. Ich werde Redmine unter /var/www/redmine/ installieren. Natürlich kann hier auch ein anderer Pfad verwendet werden.

Mit den folgenden Befehlen wird Redmine heruntergeladen und anschließend entpackt:

cd /var/www/
sudo wget https://www.redmine.org/releases/redmine-4.1.1.zip
sudo apt install unzip
sudo unzip redmine-4.1.1.zip
sudo mv redmine-4.1.1 redmine

Berechtigungen für /var/www/redmine/ ändern

Damit auf das Verzeichnis /var/www/redmine/ zugegriffen werden kann, übernehme ich den Besitz mit folgendem Befehl (UBUNTUBENUTZER ist mit dem Ubuntu-Benutzer zu ersetzen. In meinem Beispiel heißt der Ubuntu-Benutzer administrator):

sudo chown -R UBUNTUBENUTZER /var/www/redmine/

Datenbankverbindung konfigurieren

Die Datenbankverbindung wird in der Datei /redmine/config/database.yml konfiguriert. Dafür muss die Datei database.yml.example zuvor entsprechend umbenannt werden.

cd /var/www/redmine/config/
cp database.yml.example database.yml
nano database.yml

Dort sind schließlich die Verbindungsparameter anzugeben. Es ist entsprechend der Benutzer zu verwenden, der vorhin bei der Datenbankerstellung angelegt wurde. In der Regel ist nur der Bereich production anzupassen:

Mit den Tasten Strg + O, ENTER und Strg + X lässt sich die Datei speichern und schließen.

Ruby installieren

Redmine ist in Ruby geschrieben und braucht daher auch Ruby, damit es funktioniert. Ruby lässt sich auf verschiedenen Wegen installieren. In dieser Anleitung habe ich bereits verschiedene Installationsmöglichkeiten für Ruby vorgestellt. Ich installiere hier Ruby 2.6 über RVM (BENUTZERNAME ist natürlich entsprechend zu ersetzen):

sudo apt-add-repository -y ppa:rael-gc/rvm
sudo apt update
sudo apt install rvm
sudo usermod -a -G rvm BENUTZERNAME
sudo reboot
rvm install 2.6
rvm list rubies

Der letzte Befehl gibt schließlich die aktivierte Ruby-Version aus. Sie sollte als "current && default" gesetzt sein:

Der Befehl ruby --version sollte dann auch die installierte Ruby-Version anzeigen.

Abhängigkeiten für Redmine installieren

Es sind noch weitere Abhängigkeiten zu installieren. Dies geschieht mit folgenden Befehlen:

sudo apt install build-essential libmysqlclient-dev
cd /var/www/redmine/
bundle install --without development test

Das optionale Paket ImageMagick lässt sich ebenfalls einfach installieren:

sudo apt install imagemagick

Verschlüsselte Cookies

Damit Sessioninformationen in verschlüsselten Cookies gespeichert werden können, muss ein zufälliger Schlüssel erzeugt werden, den Rails später verwenden kann:

bundle exec rake generate_secret_token

Datenbankstruktur erstellen

Um die Redminedatenbank initial befüllen zu lassen, sind folgende Befehle zu verwenden:

RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:load_default_data

Beim zweiten Befehl ist das entsprechende Länderkürzel anzugeben, etwa de.

Passenger installieren

Um Redmine korrekt ausführen zu können, muss das Passenger-Modul installiert werden:

sudo apt install libcurl4-openssl-dev apache2-dev libapr1-dev libaprutil1-dev
gem install passenger --no-document
passenger-install-apache2-module

Während des letzten Befehls erscheint eine Konfiguration, die wir später noch für die Apache-Konfiguration brauchen. Diese sollte daher einmal gesichert werden. In meinem Beispiel etwa:

LoadModule passenger_module /usr/share/rvm/gems/ruby-2.6.6/gems/passenger-6.0.7/buildout/apache2/mod_passenger.so
<IfModule mod_passenger.c>
  PassengerRoot /usr/share/rvm/gems/ruby-2.6.6/gems/passenger-6.0.7
  PassengerDefaultRuby /usr/share/rvm/gems/ruby-2.6.6/wrappers/ruby
</IfModule>

Als nächstes erstelle ich zwei neue Konfigurationsdateien:

cd /etc/apache2/mods-available/
sudo touch passenger.load passenger.conf

Von der vorher gesicherten Konfiguration wird jetzt die erste Zeile LoadModule… in der neu angelegten Datei passenger.load eingetragen:

sudo nano passenger.load

Anschließend wird der komplette Block IfModule… in der Datei passenger.conf eingetragen:

sudo nano passenger.conf

Das Passenger-Modul ist jetzt noch zu aktivieren:

sudo a2enmod passenger

Apache konfigurieren

Der Apache erfordert noch einige weitere Konfigurationen, damit später alles reibungslos läuft. Ich erstelle einen VirtualHost für Redmine, wo ich alle relevanten Konfigurationen vornehme:

cd /etc/apache2/sites-available/
sudo nano redmine.conf

Dort nehme ich folgende Konfiguration vor:

<VirtualHost *:80>
  ServerName 192.168.0.67
  ServerAlias redmine
  DocumentRoot /var/www/redmine/public

  <Directory /var/www/redmine/public>
    AllowOverride all
    Options -MultiViews 
    Require all granted
  </Directory>
</VirtualHost>

Die neue Konfiguration muss jetzt noch eingebunden werden:

sudo a2ensite redmine.conf

Damit alle neuen Konfigurationen (Passenger und VirtualHost) auch geladen werden, muss der Apache Webserver noch neu gestartet werden:

sudo service apache2 restart

Installation testen

Die Installation von Redmine ist jetzt komplett. Wenn alles richtig gemacht wurde, lässt sich Redmine jetzt im Browser aufrufen:

Redmine unter Ubuntu zu installieren wäre also erledigt. Künftige Updates von Redmine fallen unkomplizierter aus. Hier ist die offizielle Updateanleitung von Redmine ein guter Ratgeber.

HTTPS aktivieren

In einer produktiven Umgebung sollte auf jeden Fall noch HTTPS aktiviert werde. Wie das geht habe ich bereits in HTTPS mit SAN-Zertifikat für Apache unter Ubuntu konfigurieren ausführlich erklärt. Der VirtualHost für Redmine sähe in diesem Beispiel wie folgt aus:

<VirtualHost *:80>
  ServerName 192.168.0.67
  ServerAlias redmine

  RewriteEngine On
  RewriteCond %{HTTPS} off
  RewriteRule (.*) https://%{SERVER_NAME}$1 [R,L]
</VirtualHost>


<VirtualHost *:443>
  SSLEngine on
  SSLCertificateFile /etc/apache2/ssl/redmine.cer
  SSLCertificateKeyFile /etc/apache2/ssl/redmine.key
  SSLProtocol -ALL +TLSv1.2 +TLSv1.3
  Header always set Strict-Transport-Security "max-age=4838400; includeSubdomains;"

  ServerName 192.168.0.67
  ServerAlias redmine
  DocumentRoot /var/www/redmine/public

  <Directory /var/www/redmine/public>
    AllowOverride all
    Options -MultiViews
    Require all granted
  </Directory>
</VirtualHost>

Weiterführende Links
https://nocksoft.de/tutorials/ruby-unter-ubuntu-installieren/
https://rvm.io/deployment/cron

Quellen
https://linuxhint.com/change_timezone_ubuntu_2004/
https://github.com/rvm/ubuntu_rvm
https://www.phusionpassenger.com/docs/advanced_guides/install_and_upgrade/apache/install/oss/rubygems_rvm.html
https://github.com/rubygems/heroku-buildpack-bundler2/pull/1