From 425a18bfab30226b900772dbb5420acfb4dbe9b6 Mon Sep 17 00:00:00 2001 From: Scrublord MacBad Date: Fri, 15 May 2026 00:07:54 +0200 Subject: [PATCH] Restructure wiki: move guides to root level with navigation - Create Home.md with main navigation - Move 5 deployment guides to root: TURN, Authentik, Monitoring, Element, Policies - Update file organization for better Gitea wiki discovery Co-Authored-By: Claude Haiku 4.5 --- ...-identity-provider.md => Authentik-OIDC.md | 0 ...stomization.md => Element-Customization.md | 0 Home.md | 59 ++++++++++++ ...monitoring-integration.md => Monitoring.md | 0 .../05-room-policies.md => Room-Policies.md | 0 .../01-turn-server-setup.md => TURN-Server.md | 0 deployment-guides/README.md | 92 ------------------- 7 files changed, 59 insertions(+), 92 deletions(-) rename deployment-guides/02-authentik-identity-provider.md => Authentik-OIDC.md (100%) rename deployment-guides/04-element-customization.md => Element-Customization.md (100%) create mode 100644 Home.md rename deployment-guides/03-monitoring-integration.md => Monitoring.md (100%) rename deployment-guides/05-room-policies.md => Room-Policies.md (100%) rename deployment-guides/01-turn-server-setup.md => TURN-Server.md (100%) delete mode 100644 deployment-guides/README.md diff --git a/deployment-guides/02-authentik-identity-provider.md b/Authentik-OIDC.md similarity index 100% rename from deployment-guides/02-authentik-identity-provider.md rename to Authentik-OIDC.md diff --git a/deployment-guides/04-element-customization.md b/Element-Customization.md similarity index 100% rename from deployment-guides/04-element-customization.md rename to Element-Customization.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..1a75e40 --- /dev/null +++ b/Home.md @@ -0,0 +1,59 @@ +# aXion1337.Chat – Wiki + +πŸ“š **Dokumentation fΓΌr Matrix Homeserver auf K3S mit Element Server Suite** + +--- + +## πŸ“– Dokumentation + +### Basis-Konfiguration +- **[Installation & Setup](01-Installation.md)** – K3S, Flux CD, ESS Deployment +- **[Task List & Roadmap](00-TASKS.md)** – Status, PrioritΓ€ten, nΓ€chste Schritte + +### Deployment Guides + +| Komponente | Link | Status | Beschreibung | +|-----------|------|--------|-------------| +| **TURN Server** | [TURN-Server.md](TURN-Server.md) | βœ… Deployed | WebRTC Video-Call Media Relay | +| **Authentik OIDC** | [Authentik-OIDC.md](Authentik-OIDC.md) | πŸ”„ Stage 2 Pending | Identity Provider fΓΌr Matrix | +| **Monitoring** | [Monitoring.md](Monitoring.md) | βœ… Deployed | Alloy β†’ Prometheus/Loki | +| **Element Customization** | [Element-Customization.md](Element-Customization.md) | βœ… Deployed | Themes, Desktop Setup, Admin Panel | +| **Room Policies** | [Room-Policies.md](Room-Policies.md) | βœ… Deployed | Retention, Publication, Auto-Join | + +--- + +## 🎯 Quick Navigation + +- **Getting Started**: Start with [01-Installation.md](01-Installation.md) +- **Current Work**: See [00-TASKS.md](00-TASKS.md) for priorities and status +- **Troubleshooting**: Each guide has a troubleshooting section + +--- + +## πŸ—οΈ Architecture + +``` +Element Web (axion1337.chat) + ↓ +MAS (account.axion1337.chat) + ↓ +Authentik OIDC (auth.axion1337.chat) + ↓ +Synapse (matrix.axion1337.chat) + ↓ +PostgreSQL + TURN (turn.axion1337.chat) +``` + +--- + +## πŸ”— External Resources + +- **K3S Host**: `49.13.132.245` +- **Monitoring**: `10.0.0.3` (Selendis) +- **Gitea Repository**: `rohana.axion1337.de/sorb/axion1337.chat-gitops` +- **Project Board**: See Issues #3-#10 for current tasks + +--- + +**Last Updated**: 2026-05-15 +**Status**: 6 features deployed, 1 in progress, 15+ pending diff --git a/deployment-guides/03-monitoring-integration.md b/Monitoring.md similarity index 100% rename from deployment-guides/03-monitoring-integration.md rename to Monitoring.md diff --git a/deployment-guides/05-room-policies.md b/Room-Policies.md similarity index 100% rename from deployment-guides/05-room-policies.md rename to Room-Policies.md diff --git a/deployment-guides/01-turn-server-setup.md b/TURN-Server.md similarity index 100% rename from deployment-guides/01-turn-server-setup.md rename to TURN-Server.md diff --git a/deployment-guides/README.md b/deployment-guides/README.md deleted file mode 100644 index 991a8f9..0000000 --- a/deployment-guides/README.md +++ /dev/null @@ -1,92 +0,0 @@ -# aXion1337.Chat – Deployment & Konfiguration Dokumentation - -Diese Dokumentation beschreibt die Einrichtung und Konfiguration des Matrix-Homeservers fΓΌr **axion1337.chat** mit Element Server Suite (ESS) v26.4.0 auf K3S mit Flux CD GitOps. - -## πŸ“‹ Übersicht Deployment-Reihenfolge - -Die Implementierungen wurden in dieser Reihenfolge durchgefΓΌhrt. FΓΌr neue Setups sollten Sie dieser Abfolge folgen: - -| # | Titel | Datei | Status | ZieldomΓ€ne | -|---|-------|-------|--------|-----------| -| 1 | TURN Server fΓΌr WebRTC Video-Calls | `01-turn-server-setup.md` | βœ… Deployed | `turn.axion1337.chat` | -| 2 | Authentik als Identity Provider | `02-authentik-identity-provider.md` | βœ… Stage 1 Deployed | `auth.axion1337.chat` | -| 3 | Monitoring mit Alloy/Prometheus/Loki | `03-monitoring-integration.md` | βœ… Deployed | lokal (10.0.0.3) | -| 4 | Element Web Anpassung & Desktop-Apps | `04-element-customization.md` | βœ… Deployed | `axion1337.chat` | -| 5 | Room Policies (Retention, Publication, Auto-Join) | `05-room-policies.md` | βœ… Deployed | Matrix Synapse | - ---- - -## πŸš€ Quick Start fΓΌr neue Deployment - -Siehe die einzelnen Dokumentationen fΓΌr detaillierte Anleitung. - ---- - -## πŸ—οΈ Architektur-Übersicht - -``` -β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” -β”‚ Element Web (Apex) β”‚ -β”‚ axion1337.chat (HTTP/TLS) β”‚ -β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ - β”‚ - β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” - β”‚ β”‚ β”‚ - β”Œβ”€β”€β”€β”€β–Όβ”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β” - β”‚ MAS β”‚ β”‚ Well-Known β”‚ β”‚Docs/Setup β”‚ - β”‚account. β”‚ β”‚matrix/* β”‚ β”‚/setup β”‚ - β”‚axion1337 β”‚ β”‚ β”‚ β”‚ β”‚ - β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ - β”‚ - β”Œβ”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” - β”‚ Authentik OIDC β”‚ - β”‚ auth.axion1337.chat β”‚ - β”‚ (Identity Provider) β”‚ - β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ - β”‚ - β”Œβ”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” - β”‚ Synapse Matrix β”‚ - β”‚ matrix.axion1337.chatβ”‚ - β”‚ (Homeserver) β”‚ - β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ -``` - ---- - -## πŸ”‘ Kritische Werte & Konfigurationen - -### Domains -- **Apex**: `axion1337.chat` (Element Web) -- **Matrix Synapse**: `matrix.axion1337.chat` -- **MAS**: `account.axion1337.chat` -- **Authentik**: `auth.axion1337.chat` -- **TURN Server**: `turn.axion1337.chat` - -### Externe Services -- **K3S Host IP**: `49.13.132.245` -- **Monitoring Host**: `10.0.0.3` (Selendis) - ---- - -## πŸ“š Dokumente im Detail - -### [01-turn-server-setup.md](01-turn-server-setup.md) -STUN/TURN Server fΓΌr WebRTC Media Relay (Video-Calls). - -### [02-authentik-identity-provider.md](02-authentik-identity-provider.md) -Authentik als OIDC Provider fΓΌr Matrix. Registrierung via Einladungs-Links. - -### [03-monitoring-integration.md](03-monitoring-integration.md) -Alloy β†’ Prometheus/Loki Monitoring Integration. - -### [04-element-customization.md](04-element-customization.md) -Custom Themes, Desktop-Setup-Scripts, Element Admin. - -### [05-room-policies.md](05-room-policies.md) -Message Retention, Room Publication, Auto-Join Policies. - ---- - -## πŸ› οΈ Wartung & Troubleshooting - -Alle Dokumentationen enthalten Troubleshooting-Sektionen fΓΌr hΓ€ufige Probleme.