Files

T

Thore Cimbal 0845af9c44 docs: decide Wiki.js (ADR-0014, supersedes 0007) + wiki build issues

ADR-0014 records the decision: Wiki.js replaces Docusaurus for the platform wiki
— the only option meeting both hard requirements (per-group abschotten AND
docs-as-code in git). BookStack ruled out (DB-only, no git). Scope excludes
homelab/docs; neckbeard docs stay in management; content in a dedicated wiki repo
(not a branch, not a monorepo). ADR-0007 set to superseded. #0047 resolved
(decided: Wiki.js). Build issues 0048 (deploy + git storage), 0049 (OIDC + roles/
abschottung: admins write, users read-only), 0050 (theming, colours+logo extracted
from homelab/wiki). #0046 becomes the umbrella. STATUS regenerated; all gates green.

2026-08-12 12:00:00 +00:00

1.7 KiB

Raw Blame History

type, id, status, created, milestone, priority, area, related

type

status

created

milestone

priority

area

issue

0046

open

2026-08-12

medium

infrastructure

docs/issues/0024-wiki-hostname-klaeren-wiki-lab-oder-axionwiki.md

docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md

Wiki in die ThreadNet Server Suite umziehen

Problem / Motivation

Das Wiki läuft aktuell als einzelner Dokploy-Stack auf Overmind (axionwiki.lab) mit Forward-Auth über den Prod-Authentik — ein bewusst provisorischer Entwicklungs-Zwischenstand (#0024, #0020). Die Vision „reproduzierbar für Dritte" verlangt aber, dass das Wiki Teil des reproduzierbaren Stacks wird, nicht ein Einzelstück auf dem Lab-Host: Eine forkende Community soll es mit dem Rest der ThreadNet Server Suite ausrollen können.

Acceptance

Das Wiki ist Bestandteil der ThreadNet-Server-Suite-Deployment-Definition (nicht mehr ein losgelöster Overmind-Stack).
Host, Reverse-Proxy und Auth-Anbindung sind für die Suite konsistent gelöst — die Forward-Auth-Verdrahtung aus gitops-Guide 09 wird dabei sauber abgelöst, nicht fortgeschleppt (sie ist genau darauf ausgelegt).
Instanzwerte (Host, Auth-Client) sind von generischer Struktur getrennt, damit ein Fork sie ohne Code-Änderung setzen kann.

Notes

Beim Umzug ändert sich der Host erneut — der axionwiki.lab-Stand aus #0024 gilt nur bis dahin. Erst nach diesem Umzug greift #0047 (breitere Oberflächen-Evaluation).

Realisierung (2026-08-12)

Der Umzug wird zugleich der Oberflächen-Wechsel: Wiki.js statt Docusaurus (ADR-0014, #0047 entschieden). Dieses Issue ist die Klammer; die konkrete Arbeit liegt in #0048 (Deployment + Git-Storage), #0049 (OIDC + Rollen/Abschottung) und #0050 (Theming). homelab/docs bleibt draußen.

1.7 KiB Raw Blame History