Alexandrie — een kennisbank op je eigen server met offlinemodus en leesbaar Markdown

Het eeuwige dilemma met kennisbanken draait meestal om de keuze tussen de cloud en lokale bestanden. Enerzijds is er Notion of Confluence, waar het handig is om teamtoegang te configureren, maar je data staat op de servers van iemand anders. Anderzijds is er Obsidian, waar alles wordt opgeslagen in puur Markdown, maar synchronisatie en samenwerking worden snel plugin-configuratie en workarounds.

Ik stuitte onlangs op het Alexandrie-project. De auteur probeerde de vertrouwde webinterface van teamwikis, de onafhankelijkheid van zelfgehoste oplossingen en offline toegang te combineren. Het bleek een interessant hulpmiddel te zijn dat je met één commando op je eigen server kunt deployen.

Wat zit er in het project

Alexandrie is geschreven met Vue/Nuxt aan de voorkant en Go aan de backend. Het is een volledig uitgeruste webapplicatie gestyled als een PWA (Progressive Web App). Je kunt het op je desktop of telefoon installeren en notities blijven openen zonder internetverbinding.

De kern wordt gevormd door CodeMirror 6, uitgebreid voor technisch schrijven.

De editor heeft verschillende handige functies die vaak ontbreken in standaard wikis:

• LaTeX-formuleondersteuning en een ingebouwde diagrambuilder direct in de tekst.
• Gesynchroniseerd scrollen tussen het bron- en voorbeeldvenster.
• Spraakinvoer via Web Speech API om snel gedachten te dicteren.
• Een snippetmanager voor snel invoegen van repetitieve API-beschrijvingen of bugreport-sjablonen.

Werkruimtestructuur en toegangsrechten

Voor team samenwerking is er een duidelijke hiërarchie. Een space is verdeeld in teams, werkruimtes, categorieën en geneste documenten.

Het permissiemodel omvat vijf niveaus: Geen, Lezen, Schrijven, Admin en Eigenaar. Je kunt iemand alleen-lezen toegang geven tot een specifieke documenttak of een pagina delen via een unieke openbare link extern.

Voor bedrijfsomgevingen is SSO-integratie via OIDC inbegrepen. Dus authenticatie koppelen aan Keycloak of Authentik is geen probleem.

Zoeken en werkorganisatie

Zoeken in kennisbanken is meestal ofwel traag of vereist een apart Elasticsearch-cluster. Alexandrie heeft een ingebouwde full-text index met gemarkeerde zoekresultaten en relevantierangschikking.

Door op Ctrl + K te drukken open je het opdrachtenpalet. Van daaruit kun je tussen pagina's navigeren, snelle acties triggeren en contexten wisselen zonder de muis aan te raken.

Kanban-borden zijn ook ingebouwd in elke werkruimte. Dit is handig wanneer je een kleine taaktracker nodig hebt direct naast specificaties en technische documentatie, zonder over te schakelen naar externe trackers.

Bestandsopslag en back-ups

Afbeeldingen, video's en bijlagen zwellen de database niet op. De applicatie kan werken met S3-compatibele opslag, of het nu MinIO, Garage, RustFS of cloudproviders zijn.

De interface bevat een ingebouwde viewer voor dertig media-bestandsformaten, inclusief een ingebedde PDF-renderer.

Exporteren is ook eenvoudig: op elk moment kun je een archief downloaden met alle documenten en metadata als een ZIP of de systeemstatus herstellen uit zo'n archief. Er is geen lock-in naar een propriëtair formaat — je krijgt normale bestanden als output.

Hoe te starten

De hele stack wordt gedeployed via Docker Compose in letterlijk een paar minuten.

# 1. Скачиваем конфиги
curl https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/.env.example -O .env.example
curl https://raw.githubusercontent.com/Smaug6739/Alexandrie/main/docker-compose.yml -O docker-compose.yml

# 2. Создаем файл переменных окружения
cp .env.example .env

# 3. Запускаем контейнеры
docker compose up -d

Na opstart is de interface beschikbaar op http://localhost:8200, waar de initiële installatiewizard je vraagt om een eigenaarsaccount aan te maken.

Voor wie is dit project

Als je een interne kennisbank nodig hebt voor een ontwikkelingsteam of een persoonlijk notitiearchief op een thuisserver, lijkt Alexandrie een solide kandidaat. Het heeft niet de bloat van Confluence of de cloudafhankelijkheid van Notion.

Natuurlijk is het project jonger dan de gevestigde reuzen, en de community is nog bescheiden. Maar de combinatie van een kant-en-klare Docker-image, PWA met offline toegang en S3-ondersteuning maakt het een handig hulpmiddel voor degenen die controle over hun data waarderen.