Stop met het Configureren van Wiki's en Begin met Documentatie Schrijven

Een bekend verhaal: je team of jij persoonlijk heeft een kennisbank nodig. Je opent Wiki.js, Outline, of, God verhoede, Confluence. Een uur later zit je diep in het configureren van PostgreSQL, Redis, S3-opslag en een driehonderd regels tellend Docker Compose-bestand. Op dat moment verdwijnt meestal de zin om een paar slimme gedachten op te schrijven.

Onlangs kwam ik LeafWiki tegen. De auteur van het project deelt deze pijn blijkbaar. Het is een eenvoudige zelfgehoste wiki die werkt volgens het "download en draai"-principe. Geen zware afhankelijkheden, gewoon één Go-binary en een datafolder.

Onder de Motorkap

LeafWiki probeert het wiel niet opnieuw uit te vinden. Het rust op drie eenvoudige dingen: Go voor de backend, React voor de interface en SQLite voor metadata. Het beste deel — de daadwerkelijke pagina-inhoud wordt opgeslagen als gewone Markdown-bestanden op schijf.

Dit betekent dat als de server plotseling crasht of je besluit naar een ander hulpmiddel te verhuizen, je data niet in een pompoen verandert die gevangen zit in een proprietaire database. Je kunt het openen met elke teksteditor of zelfs Obsidian.

Wat Het in de Praktijk Goed Maakt

Ik zie vaak hulpmiddelen die zichzelf "eenvoudig" noemen maar eigenlijk volledig beheer vereisen. LeafWiki is hier eerlijker over.

Boomstructuur In plaats van Chaos

Veel moderne notitie-hulpmiddelen leunen naar "platte" lijsten met tags. Hier krijg je een klassieke boomstructuur. Je definieert de hiërarchie zelf, en belangrijk: je kunt pagina's binnen secties handmatig sorteren. Dit is cruciaal voor onboarding of procedurele documenten waar de leesvolgorde belangrijk is.

Een Editor Die Niet In de Weg Zit

Het wordt geleverd met een ingebouwde Markdown-editor met live preview. Het ondersteunt tabellen, takenlijsten, voetnoten en zelfs Mermaid-diagrammen met KaTeX-wiskundeformules. Er is automatische aanvulling voor interne links — begin met typen van de naam van een andere pagina, en de wiki voegt automatisch de correcte link in.

Slimme Links

Het systeem houdt backlinks bij. Op elke pagina kun je zien wat ernaar verwijst. Als je een pagina hernoemt of verplaatst, kan LeafWiki automatisch links in andere documenten bijwerken (deze functie moet worden ingeschakeld met een flag --enable-link-refactor).

Backup voor de Paranoïde

Naast simpelweg de datafolder kopiëren, hebben recente versies experimentele Git-backupondersteuning toegevoegd. De wiki zal automatisch wijzigingen naar je remote repository pushen volgens een schema.

Voor Wie Dit Niet Is

Laat me voorop duidelijk zijn: dit is geen Notion-vervanger. Er is geen echte realtime samenwerkende bewerking waarbij je de cursors van collega's ziet. Ook geen complexe publicatiegoedkeuringsworkflows. Als je tien personen tegelijkertijd dezelfde paragraaf wilt laten bewerken — zoek dan verder.

Bovendien ondersteunt LeafWiki nog geen granulaire toegangscontrole tot individuele takken van de boom. Rollen bestaan (admin, editor, lezer), maar ze gelden voor de hele wiki.

Hoe te Beginnen

Als je Docker geïnstalleerd hebt, duurt opstarten ongeveer dertig seconden.

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

De --allow-insecure=true-flag is nodig als je het project lokaal draait zonder HTTPS. Als je van plan bent het extern bloot te stellen via Nginx of een andere proxy, is het beter om deze flag te verwijderen.

Trouwens, voor minimalisten is er een kant-en-klare installer voor Linux die LeafWiki registreert als systeemservice:

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

Werken Vanaf Mobiele Apparaten

De interface is responsive. Tekst bewerken vanaf een telefoon is een twijfelachtig genot, maar documentatie lezen onderweg of snel een typefout repareren is perfect haalbaar.

LeafWiki wint je met zijn voorspelbaarheid. Het is perfect voor:

• Een persoonlijk technisch dagboek of kennisbank.
• Documentatie voor een klein project.
• Interne runbooks voor beheerders of DevOps-engineers.

Als je het beu bent om te vechten met logge wiki-engines en gewoon Markdown wilt schrijven dat netjes wordt georganiseerd — geef dit project dan een kans. Het heeft momenteel minder dan duizend sterren op GitHub, maar het heeft zeker het potentieel om "dat eenvoudige hulpmiddel" te worden waar je naar op zoek was.