Aufhören, Wikis zu konfigurieren, und anfangen, Dokumentation zu schreiben

Eine vertraute Geschichte: Dein Team oder du persönlich braucht eine Wissensdatenbank. Du öffnest Wiki.js, Outline oder, Gott bewahre, Confluence. Eine Stunde später findest du dich tief in der Konfiguration von PostgreSQL, Redis, S3-Speicher und einer dreihundert Zeilen langen Docker-Compose-Datei wieder. An diesem Punkt verschwindet meistens die Lust, ein paar kluge Gedanken aufzuschreiben.

Kürzlich bin ich auf LeafWiki gestoßen. Der Autor des Projekts teilt offenbar diesen Schmerz. Es ist ein schlichtes, selbst gehostetes Wiki, das nach dem Prinzip „Herunterladen und starten" funktioniert. Keine schweren Abhängigkeiten, nur ein einzelnes Go-Binary und ein Datenordner.

Unter der Haube

LeafWiki versucht nicht, das Rad neu zu erfinden. Es basiert auf drei einfachen Dingen: Go für das Backend, React für die Oberfläche und SQLite für Metadaten. Das Beste daran — der eigentliche Seiteninhalt wird in einfachen Markdown-Dateien auf der Festplatte gespeichert.

Das bedeutet, dass wenn der Server plötzlich abstürzt oder du zu einem anderen Tool wechseln möchtest, deine Daten nicht wie ein Kürbis in einer proprietären Datenbank gefangen werden. Du kannst sie mit jedem Texteditor oder sogar Obsidian öffnen.

Was es in der Praxis gut macht

Ich sehe oft Tools, die sich selbst als „einfach" bezeichnen, aber tatsächlich eine vollständige Administration erfordern. LeafWiki ist hier ehrlicher.

Baumstruktur statt Chaos

Viele moderne Notiz-Tools setzen auf „flache" Listen mit Tags. Hier bekommst du eine klassische Baumstruktur. Du definierst die Hierarchie selbst, und wichtig — du kannst Seiten innerhalb von Abschnitten manuell sortieren. Das ist entscheidend für Onboarding- oder Verfahrensdokumente, bei denen die Lesereihenfolge wichtig ist.

Ein Editor, der nicht im Weg steht

Er wird mit einem eingebauten Markdown-Editor mit Live-Vorschau geliefert. Er unterstützt Tabellen, Aufgabenlisten, Fußnoten und sogar Mermaid-Diagramme mit KaTeX-Matheformeln. Es gibt eine Auto-Vervollständigung für interne Links — beginne den Namen einer anderen Seite einzutippen, und das Wiki fügt automatisch den korrekten Link ein.

Intelligente Links

Das System verfolgt Backlinks. Auf jeder Seite kannst du sehen, was sie referenziert. Wenn du eine Seite umbenennst oder verschiebst, kann LeafWiki automatisch Links in anderen Dokumenten aktualisieren (diese Funktion muss mit einem Flag --enable-link-refactor aktiviert werden).

Backup für Paranoiker

Über das einfache Kopieren des Datenordners hinaus wurde in neueren Versionen experimentelle Git-Backup-Unterstützung hinzugefügt. Das Wiki wird Änderungen automatisch nach einem Zeitplan auf dein Remote-Repository pushen.

Wen es nicht betrifft

Ich möchte von vornherein klarstellen: Das ist kein Notion-Ersatz. Es gibt keine Echtzeit-Zusammenarbeit, bei der du die Cursor deiner Kollegen siehst. Auch keine komplexen Freigabe-Genehmigungsworkflows. Wenn du zehn Personen brauchst, die gleichzeitig denselben Absatz bearbeiten — suche weiter.

Außerdem unterstützt LeafWiki noch keine granulare Zugriffskontrolle bis zu einzelnen Zweigen des Baums. Rollen existieren (Admin, Editor, Leser), aber sie gelten für das gesamte Wiki.

Wie du loslegst

Wenn du Docker installiert hast, dauert der Start etwa dreißig Sekunden.

docker run -p 8080:8080 \
    -v ~/leafwiki-data:/app/data \
    ghcr.io/perber/leafwiki:latest \
    --jwt-secret=super-secret-key \
    --admin-password=your-password \
    --allow-insecure=true

Das Flag --allow-insecure=true wird benötigt, wenn du das Projekt lokal ohne HTTPS betreibst. Wenn du vorhast, es extern über Nginx oder einen anderen Proxy zugänglich zu machen, ist es besser, dieses Flag zu entfernen.

Übrigens gibt es für Minimalismus-Enthusiasten einen fertigen Installer für Linux, der LeafWiki als Systemdienst registriert:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/perber/leafwiki/main/install.sh)"

Arbeiten von Mobilgeräten aus

Die Oberfläche ist responsiv. Text auf dem Handy zu bearbeiten ist ein fragwürdiges Vergnügen, aber Dokumentation unterwegs zu lesen oder schnell einen Tippfehler zu korrigieren, ist problemlos möglich.

LeafWiki gewinnt dich durch seine Vorhersehbarkeit. Es ist perfekt geeignet für:

• Ein persönliches technisches Tagebuch oder eine Wissensdatenbank.
• Dokumentation für ein kleines Projekt.
• Interne Runbooks für Admins oder DevOps-Ingenieure.

Wenn du es leid bist, gegen schwergewichtige Wiki-Engines anzukämpfen und einfach Markdown schreiben möchtest, das ordentlich organisiert wird — probiere dieses Projekt aus. Es hat derzeit unter tausend Sterne auf GitHub, aber es hat definitiv das Potenzial, „dieses einfache Tool" zu werden, nach dem du gesucht hast.