So erstellen Sie ein minimalistisches Kanban in Linux mit Kanboard

Kanboard ist ein leichtgewichtiger Kanban-Projekt-Tracker, den Sie auf Ihrem eigenen Server hosten können. Im Gegensatz zu anderen Kanban-Trackern zielt es darauf ab, eine einfache und intuitive Benutzeroberfläche zu schaffen, auf die Sie von überall zugreifen können.

Dieser Artikel zeigt Ihnen, wie Sie Kanboard in Ubuntu 22.04 installieren können. Er wird auch den Prozess zur Erweiterung von Kanboard mit Community-Plugins hervorheben.

Inhaltsverzeichnis

• Warum Kanboard verwenden?
• Kanboard installieren
• Kanboard für SSL einrichten
• Anmelden und ein Kanban-Board erstellen
• Anpassen Ihres Kanban-Boards mit Plugins
• Häufig gestellte Fragen

Warum Kanboard verwenden?

Einer der größten Vorteile von Kanboard ist, dass es auf fast jedem Server durch die Magie von Docker funktionieren kann. Daher ist das Hosting von Kanboard sowohl schmerzlos als auch einfach, selbst für nicht-technische Benutzer.

Darüber hinaus bietet Kanboard auch eine flexible Plugin-Plattform. Dazu gehört die Möglichkeit, Tags zu erstellen, die Zeit zu verfolgen und benutzerdefinierte Skripte auszuführen. Zum Beispiel können Sie ein Plugin erstellen, das die Eigenschaften jeder Karte je nach Inhalt aktualisiert.

Tipp: Lernen Sie, wie Sie effizient und effektiv Aufgaben priorisieren, indem Sie die Eisenhower-Matrix verstehen.

Kanboard installieren

1. Der erste Schritt zur Installation von Kanboard besteht darin, sicherzustellen, dass Ihr System auf dem neuesten Stand ist. Sie können dies tun, indem Sie den folgenden Befehl ausführen:

sudo apt update  
sudo apt upgrade

1. Installieren Sie den Repository-Schlüssel des Docker-Projekts:

sudo install -m 0755 -d /etc/apt/keyrings  
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg  
sudo chmod a+r /etc/apt/trusted.gpg.d/docker.gpg

1. Erstellen Sie eine neue apt-Repository-Datei mit Ihrem bevorzugten Texteditor:

sudo nano /etc/apt/sources.list.d/docker.list

1. Schreiben Sie die Repository-Informationen für das offizielle Docker-Repository:

deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable

1. Speichern Sie Ihre neue Repository-Datei, indem Sie Ctrl + O drücken, dann Ctrl + X.

2. Aktualisieren Sie die Repository-Details Ihres Systems, indem Sie den folgenden Befehl ausführen:

sudo apt update

1. Installieren Sie die Docker-Engine zusammen mit ihren Abhängigkeiten mit apt:

sudo apt install wget docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin

Kanboard beziehen

Sobald Sie die Docker-Engine ordnungsgemäß installiert haben, besteht der nächste Schritt darin, das Docker-Compose-Skript für Kanboard abzurufen. Dies ist eine kleine Textdatei, die eine Liste von Optionen enthält, die Docker anweisen, wie Kanboard automatisch erstellt werden soll.

1. Erstellen Sie einen separaten Ordner in Ihrem Home-Verzeichnis für Kanboard:

mkdir ~/kanboard  
cd ~/kanboard

1. Erstellen Sie eine neue Textdatei mit dem Namen “docker-compose.yml” über Ihren bevorzugten Texteditor:

nano ~/kanboard/docker-compose.yml

1. Kopieren Sie den folgenden Codeblock und fügen Sie ihn in Ihre “docker-compose.yml”-Datei ein:

version: '2'  
services:  
  kanboard:  
    image: kanboard/kanboard:latest  
    ports:  
      - 8080:80  
    volumes:  
      - kanboard_data:/var/www/app/data  
      - kanboard_plugins:/var/www/app/plugins  
    environment:  
      DATABASE_URL: mysql://kanboard:!#REPLACE-ME@db/kanboard  
      PLUGIN_INSTALLER: true  
  db:  
    image: mariadb:latest  
    command: --default-authentication-plugin=mysql_native_password  
    environment:  
      MYSQL_ROOT_PASSWORD: !#REPLACE-ME  
      MYSQL_DATABASE: kanboard  
      MYSQL_USER: kanboard  
      MYSQL_PASSWORD: !#REPLACE-ME  
    volumes:  
    - db:/var/lib/mysql  
volumes:  
  kanboard_data:  
  kanboard_plugins:  
  db:

1. Öffnen Sie ein neues Terminal und generieren Sie ein sicheres Passwort mit dem folgenden Befehl:

cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 16 | head -n 1

1. Gehen Sie zurück zu Ihrem vorherigen Terminal und fügen Sie Ihr sicheres Passwort in jede Instanz von “#!REPLACE-ME” in der Datei ein.

1. Speichern Sie Ihre “docker-compose.yml”-Datei und beenden Sie sie, indem Sie Ctrl + O drücken, dann Ctrl + X.

2. Sie können jetzt Ihren Kanboard-Docker-Container erstellen, indem Sie den folgenden Befehl ausführen:

docker compose up -d

Gut zu wissen: Lernen Sie, wie Sie heute ein Offline-Kanban-Board mit Obsidian.md erstellen können.

Kanboard für SSL einrichten

An diesem Punkt haben Sie jetzt eine teilweise funktionierende Kanboard-Installation. Um jedoch sicher darauf zugreifen zu können, müssen Sie zuerst einen Nginx-Proxy erstellen. Dies wird als Ihr webseitiger Server dienen, der Lastenausgleich und SSL bereitstellt.

1. Installieren Sie den Nginx-Webserver:

sudo apt install nginx

1. Erstellen Sie eine Standortkonfigurationsdatei für Ihren Nginx-Proxy:

sudo nano /etc/nginx/sites-available/kanboard

1. Kopieren Sie den folgenden Codeblock und fügen Sie ihn in Ihre neue Standortkonfigurationsdatei ein:

server {  
    listen 80;  
    listen [::]:80;  
  
    root                    /var/www/html;  
    server_name             my-kanban-domain-url.com;  
  
    location / {  
        proxy_set_header    X-Forwarded-For $remote_addr;  
        proxy_set_header    Host $http_host;  
        proxy_pass          http://localhost:8080;  
}  
}

Hinweis: Ersetzen Sie “my-kanban-domain-url.com” durch den tatsächlichen Domainnamen.

1. Erstellen Sie einen symbolischen Link für Ihren Kanboard-Proxy:

sudo ln -s /etc/nginx/sites-available/kanboard /etc/nginx/sites-enabled/kanboard

1. Laden Sie Ihren Nginx-Dienstdaemon neu:

sudo systemctl reload nginx.service

Ein SSL-Zertifikat für Kanboard erhalten

Mit Ihrem Proxy können Sie jetzt ein SSL-Zertifikat für Ihr Kanboard anfordern. Dieser Abschnitt zeigt Ihnen, wie Sie ein kostenloses Zertifikat über das Certbot der Electronic Frontier Foundation (EFF) erhalten.

1. Zuerst müssen Sie den Kern-Snap-Daemon Ihres Systems installieren und aktualisieren:

sudo snap install core  
sudo snap refresh core

1. Installieren Sie das Certbot-Snap-Paket:

sudo snap install --classic certbot

1. Erstellen Sie einen symbolischen Link zwischen dem Certbot-Snap-Binärprogramm und dem Standard-Binärverzeichnis Ihres Systems:

sudo ln -s /snap/bin/certbot /usr/bin/certbot

1. Testen Sie, ob Certbot läuft, indem Sie es verwenden, um sich bei der EFF zu registrieren:

sudo certbot register --agree-tos --email [email protected]

1. Generieren Sie ein SSL-Zertifikat für Ihren Domainnamen, indem Sie den folgenden Befehl ausführen:

sudo certbot

Wählen Sie die Domain aus dem Eintrag aus, und es wird seine Arbeit tun, um SSL für Ihre Domain zu generieren.

Gut zu wissen: Erfahren Sie mehr über die Verschlüsselung über das Internet, indem Sie Ihr eigenes selbstsigniertes SSL-Zertifikat erstellen.

Anmelden und ein Kanban-Board erstellen

Sie können Kanboard jetzt verwenden, um Kanban-Boards zu erstellen und zu verwalten. Um dies zu tun, melden Sie sich bei Ihrer Kanboard-Instanz an, indem Sie ihren Domainnamen in einem Webbrowser aufrufen.

1. Verwenden Sie “admin” als Benutzernamen und Passwort auf dem Anmeldebildschirm.
2. Klicken Sie auf “Neues Projekt”, um ein öffentliches Kanban-Board zu erstellen.

1. Geben Sie einen Namen und einen URL-Slug für Ihr neues Board an.
2. Klicken Sie auf “Öffentlicher Zugriff” in der linken Seitenleiste der Seite.

1. Klicken Sie auf die blaue Schaltfläche “Öffentlichen Zugriff aktivieren”. Dadurch wird ein RSS-Feed und ein öffentlich einsehbarer Link erstellt, den Sie mit Nicht-Kanboard-Benutzern teilen können.

1. Klicken Sie auf die Schaltfläche “Board” in der oberen linken Ecke der Seite, um auf Ihr Board zuzugreifen und neue Elemente zu erstellen.

Einen Benutzer für kollaborative Kanban-Boards erstellen

Neben dem Teilen von öffentlich zugänglichen “nur ansehen”-Boards können Sie Kanboard auch verwenden, um kollaborative “Aufgaben”-Boards zwischen mehreren lokalen Benutzern zu erstellen.

1. Klicken Sie auf das Symbol des Admin-Benutzers in der oberen rechten Ecke der Seite und wählen Sie “Benutzermanagement”.

1. Klicken Sie auf den Link “Neuer Benutzer” in der oberen linken Seitenleiste der Seite.
2. Dies öffnet ein kleines Dialogfeld, in dem Kanboard Sie nach dem Benutzernamen und Passwort Ihres neuen Benutzers fragt.

1. Scrollen Sie nach unten zum unteren Ende des Eingabefelds und klicken Sie auf das Dropdown-Feld unter der Kategorie “Projekte”.

1. Wählen Sie das Kanban-Board aus, dem der Benutzer angehören soll.

1. Klicken Sie auf “Speichern”, um Ihr neues Benutzerkonto zu erstellen.

Anpassen Ihres Kanban-Boards mit Plugins

Eine der großartigen Funktionen von Kanboard ist, dass es einen Rahmen bietet, um Ihr Board über die grundlegenden Funktionen hinaus zu erweitern. Das bedeutet, dass Sie nicht auf die Entwickler angewiesen sind, um eine benutzerdefinierte Funktion für Ihren Server hinzuzufügen.

1. Um ein neues Plugin hinzuzufügen, klicken Sie auf das Symbol des Admin-Benutzers in der oberen rechten Ecke der Seite und wählen Sie “Plugins”.

1. Klicken Sie auf die Kategorie “Plugin-Verzeichnis” in der linken Seitenleiste der Seite.

1. Finden Sie ein Plugin, das Sie auf Ihrem Kanboard-Server installieren möchten. In meinem Fall werde ich “MarkdownPlus” installieren, um das grundlegende Markdown auf meinem Server zu erweitern.

1. Klicken Sie auf “Installieren”, und aktualisieren Sie die Webseite, um das Plugin ordnungsgemäß auf Ihrem Server zu laden.

FYI: Kanban ist nicht der einzige Weg, um Aufgaben und Daten zu verwalten. Lernen Sie, wie Sie Ihre To-Do-Listen und Daten mit Todoist optimieren können.

Häufig gestellte Fragen

Ist es möglich, die Inhalte meines Kanban-Boards zu sichern?

Ja. Um ein bestimmtes Kanban-Board zu sichern, klicken Sie auf das Zahnradsymbol auf dem Board, das Sie exportieren möchten, und klicken Sie dann auf “Exporte”.

Dies öffnet ein kleines Eingabefeld, in dem Kanboard Sie nach einem Datumsbereich fragt, den Sie exportieren möchten. Geben Sie ein Start- und Enddatum an und klicken Sie auf “Exportieren”.

Ist es möglich, die “gesperrte” Periode meines Kanban-Boards zurückzusetzen?

Ja. Es ist möglich, den Sperrzeitgeber eines bestimmten Benutzers in Kanboard zurückzusetzen. Klicken Sie dazu auf das Symbol des Admin-Benutzers in der oberen rechten Ecke der Seite. Wählen Sie dann den Punkt “Benutzermanagement” aus und klicken Sie auf den Namen des gesperrten Benutzers. Gehen Sie schließlich zur Kategorie “Sicherheit” und klicken Sie auf “Diesen Benutzer entsperren”.

Ist es möglich, die config.php-Datei in meinem Kanboard-Container zu ändern?

Ja. Das könnte jedoch die Konsistenz Ihres Docker-Images gefährden. Stattdessen empfehlen die Entwickler des Programms, dass Sie die Umgebungsvariablen in Ihrer docker-compose.yml-Datei verwenden, wenn Sie die Werte Ihrer Kanboard-Instanz konfigurieren.

Bildnachweis: Eden Constantino über Unsplash. Alle Änderungen und Screenshots von Ramces Red.