Installationsanleitung für Kanboard auf Ubuntu 18.04

Einführung

Kanboard ist eine kostenfreie, quelloffene Projektmanagement-Software, die dafür entwickelt wurde, Team-Workflows mithilfe der Kanban-Methode zu visualisieren und effizienter zu gestalten.

Diese Anleitung zeigt dir Schritt für Schritt, wie du Kanboard auf einem Ubuntu-18.04-System einrichtest.

Voraussetzungen

• Ein Ubuntu-18.04-Server. In diesem Beispiel wird die IP-Adresse 203.0.113.1 verwendet.
• Ein Benutzerkonto mit Sudo-Rechten.

Schritt 1: System aktualisieren

Stelle zunächst über ein SSH-Terminal eine Verbindung zum Server als Sudo-Benutzer her. Führe dann ein Systemupdate durch und installiere Git.

sudo apt update && sudo apt upgrade -y
sudo apt install -y git
sudo reboot

Nachdem der Server neu gestartet wurde, melde dich wieder mit demselben Sudo-Benutzer an, um fortzufahren.

Schritt 2: Apache installieren

Kanboard benötigt einen Webserver. In diesem Fall wird Apache 2.4 installiert.

sudo apt install apache2 -y

Starte anschließend den Apache-Dienst und aktiviere ihn für den automatischen Start beim Booten:

sudo systemctl enable --now apache2.service

Schritt 3: MariaDB installieren

Standardmäßig verwendet Kanboard SQLite, doch für eine bessere Leistung in produktiven Umgebungen empfiehlt sich die Nutzung von MariaDB (oder MySQL).

Installiere den MariaDB-Server sowie die zugehörigen Client-Programme:

sudo apt install -y mariadb-server mariadb-client

Aktiviere den MariaDB-Dienst und richte ihn so ein, dass er beim Systemstart automatisch ausgeführt wird:

sudo systemctl enable --now mariadb.service

Führe anschließend das Sicherheits-Skript aus, um deine MariaDB-Installation abzusichern:

sudo mysql_secure_installation

Beantworte die Eingabeaufforderungen wie folgt. Achte darauf, ein starkes und individuelles Passwort für den Root-Benutzer zu vergeben.

• Aktuelles Root-Passwort eingeben (Enter für kein Passwort): Drücke Enter
• Root-Passwort setzen? [Y/n]: Y
• Neues Passwort: <dein-passwort>
• Passwort erneut eingeben: <dein-passwort>
• Anonyme Benutzer entfernen? [Y/n]: Y
• Root-Zugriff aus der Ferne verbieten? [Y/n]: Y
• Testdatenbank und Zugriffe darauf löschen? [Y/n]: Y
• Berechtigungstabellen jetzt neu laden? [Y/n]: Y

Schritt 4: PHP 7 installieren

Kanboard benötigt mindestens PHP in Version 5.3.9. In dieser Anleitung verwenden wir PHP 7.2 samt wichtiger Erweiterungen, die über die offiziellen Ubuntu-Repositories verfügbar sind.

sudo apt install -y php7.2 php7.2-mysql php7.2-gd php7.2-mbstring php7.2-common php7.2-opcache php7.2-cli php7.2-xml

Schritt 5: Kanboard installieren

Lade zunächst die aktuelle Version von Kanboard herunter und platziere sie im vorgesehenen Verzeichnis:

cd /var/www/html
sudo git clone https://github.com/kanboard/kanboard.git
sudo chown -R www-data:www-data kanboard/data

Erstelle nun eine eigene MySQL-Datenbank sowie einen Benutzer für Kanboard:

mysql -u root -p -e "CREATE DATABASE kanboard;"
mysql -u root -p kanboard < /var/www/html/kanboard/app/Schema/Sql/mysql.sql
mysql -u root -p -e "CREATE USER 'kanboarduser'@'localhost' IDENTIFIED BY 'yourpassword';"
mysql -u root -p -e "GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboarduser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;"
mysql -u root -p -e "FLUSH PRIVILEGES;"

Hinweis: Gib bei Aufforderung das zuvor gesetzte MariaDB-Root-Passwort ein. Ersetze yourpassword durch ein sicheres Passwort.

Passe im Anschluss die Konfigurationsdatei von Kanboard an, um statt SQLite die MySQL-Datenbank zu verwenden:

cd /var/www/html/kanboard
sudo mv config.default.php config.php

Öffne nun die Konfigurationsdatei mit einem Editor deiner Wahl:

sudo vi config.php

Suche folgenden Konfigurationsblock:

// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'sqlite');

// Mysql/Postgres username
define('DB_USERNAME', 'root');

// Mysql/Postgres password
define('DB_PASSWORD', '');

// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');

// Mysql/Postgres database name
define('DB_NAME', 'kanboard');

Ändere die Einträge wie folgt ab:

// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'mysql');

// Mysql/Postgres username
define('DB_USERNAME', 'kanboarduser');

// Mysql/Postgres password
define('DB_PASSWORD', 'yourpassword');

// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');

// Mysql/Postgres database name
define('DB_NAME', 'kanboard');

Starte den Apache-Webserver neu, um die Änderungen zu übernehmen:

sudo systemctl restart apache2.service

Öffne anschließend deinen Webbrowser und rufe http://203.0.113.1/kanboard auf, um Kanboard zu starten.

Melde dich mit den Standardzugangsdaten an:

• Benutzername: admin
• Passwort: admin

Hinweis: Aus Sicherheitsgründen solltest du das Standardpasswort des Admins sofort über das Benutzerverwaltungsmenü oben rechts im Admin-Dropdown ändern.

Schritt 6 (Optional): Zend OpCache konfigurieren

Um die Leistung deiner Kanboard-Installation zu verbessern, empfiehlt es sich, die Einstellungen für den Zend OpCache anzupassen. Diese Caching-Funktion ist standardmäßig aktiviert.

Wenn du Kanboard auf einem einzelnen Server in einer Produktionsumgebung betreibst, kannst du mit den folgenden Werten eine solide Ausgangsbasis für Performance-Optimierungen schaffen.

Öffne dazu die Zend-OpCache-Konfigurationsdatei:

sudo vi /etc/php/7.2/apache2/conf.d/10-opcache.ini

Trage in die Datei folgende Einstellungen ein:

zend_extension=opcache.so;
opcache.enable=1;
opcache.file_cache=/tmp/opcache
opcache.validate_timestamps=0
opcache.revalidate_freq=0
opcache.memory_consumption=192
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=1979
opcache.fast_shutdown=1

Starte den Apache-Webserver neu, um die Änderungen wirksam werden zu lassen:

sudo systemctl restart apache2.service

Schritt 7 (Optional): Täglichen Cronjob für Berichte und Statistiken einrichten

Damit Kanboard automatisch aktuelle Auswertungen und Statistiken erzeugt, solltest du einen täglichen Cronjob für den Benutzer www-data einrichten.

Bearbeite die Crontab-Datei für den Benutzer www-data:

sudo crontab -u www-data -e

Füge folgenden Eintrag hinzu, um den Cronjob zu planen:

0 3 * * * cd /var/www/html/kanboard && ./cli cronjob >/dev/null 2>&1

Speichere und schließe die Datei. Dadurch wird sichergestellt, dass Berichte und Auswertungen täglich um 3:00 Uhr morgens automatisch aktualisiert werden.

Fazit

Nach dem erfolgreichen Abschluss dieser Anleitung verfügst du über eine funktionierende Kanboard-Installation auf Ubuntu 18.04 – inklusive Performance-Optimierung und automatischer Berichtserstellung. Die Umgebung ist bereit für eine effiziente Zusammenarbeit über Kanban-Boards und kann nach Bedarf an die individuellen Anforderungen deines Teams angepasst werden. Achte dabei stets auf bewährte Sicherheitsmaßnahmen wie Passwortänderungen und regelmäßige Systemüberwachung.