Files
management/docs/issues/0048-wikijs-in-der-suite-deployen.md
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

35 lines
1.2 KiB
Markdown

---
type: issue
id: "0048"
status: open
created: 2026-08-12
milestone: M4
priority: medium
area: infrastructure
related: [docs/adr/0014-wikijs-loest-docusaurus-ab.md, docs/issues/0046-wiki-in-threadnet-server-suite-umziehen.md]
---
# Wiki.js in der ThreadNet Server Suite deployen (k8s + Postgres + Git-Storage)
## Problem / Motivation
ADR-0014: Wiki.js löst Docusaurus ab und wird Teil der ThreadNet Server Suite
(k8s), nicht mehr ein Overmind-Einzelstack. Braucht das Deployment plus den
Inhalts-Speicher.
## Acceptance
- Wiki.js läuft in der Suite (k8s): Deployment, **Postgres** (Rendern/Auth/Suche),
Ingress/TLS, in die GitOps-Definition aufgenommen (Flux).
- **Neues `wiki`-Repo** auf git.lab angelegt (gespiegelt wie die übrigen), als
Wiki.js **Git-Storage** eingebunden (bidirektionaler Sync) — Inhalt liegt in git
(hartes Kriterium, ADR-0014).
- Grundstruktur für **Betrieb** und **Anwender** angelegt (zwei Bereiche);
`homelab/docs` ausdrücklich **nicht** eingebunden.
- Postgres ist gesichert (Backup), da git nur Inhalt, nicht den Laufzeit-Zustand
hält.
## Notes
Ersetzt den Forward-Auth-Zwischenstand auf Overmind (Guide 09, #0024). OIDC +
Rollen kommen in #0049, Theming in #0050. Umbrella: #0046.