119 lines
4.2 KiB
Markdown
119 lines
4.2 KiB
Markdown
# 🎬 Bratonien Tech – Kapitel 16: Wiki (Self-Hosted mit Wiki.js)
|
||
|
||
---
|
||
|
||
🎵 Intro
|
||
Szene: Talking Head (du oder Barney), Bratonien Tech Logo eingeblendet.
|
||
Voiceover / Gesprochen:
|
||
„Hallo und herzlich willkommen bei Bratonien Tech.
|
||
Ich bin [dein Name oder Barney] von Bratonien Cosplay.
|
||
Dieses Format ist für alle großen und kleinen Technik-Streamer, Nerds – oder die, die es noch werden wollen.
|
||
In dieser Reihe bauen wir aus einem alten Office-PC ein komplettes Homelab – oder wie ich es gerne nenne: Bratoniens Kontrollzentrum.
|
||
Heute kümmern wir uns um das Herzstück der Dokumentation: ein eigenes Wiki.
|
||
Damit behalten wir den Überblick über alle Projekte, Konfigurationen und Ideen – und haben jederzeit alles an einem Ort.“
|
||
|
||
---
|
||
|
||
1. Warum ein eigenes Wiki?
|
||
Szene: Vergleichsfolie: lose Textdateien vs. Wiki.js Logo.
|
||
Voiceover:
|
||
„Notizen in Textdateien oder verstreut in Tools kennt jeder – schnell wird es unübersichtlich.
|
||
Mit Wiki.js haben wir dagegen eine zentrale Plattform: modern, im Browser erreichbar und mit Markdown-Unterstützung.
|
||
Das Beste: Es läuft vollständig bei uns im Homelab – volle Kontrolle über unsere Daten.“
|
||
|
||
---
|
||
|
||
2. Voraussetzungen
|
||
Szene: Textfolie mit Specs.
|
||
Voiceover:
|
||
„Wir arbeiten wieder in einem Debian 12 LXC-Container.
|
||
Ein vCore, 1 bis 2 GB RAM und rund 10 GB Speicher reichen völlig aus.
|
||
Dazu eine Domain, DynDNS und Nginx Proxy Manager für den externen Zugriff.“
|
||
|
||
---
|
||
|
||
3. Container vorbereiten
|
||
Szene: Terminalaufnahme.
|
||
Voiceover:
|
||
„Wie immer starten wir mit einem Update und installieren die nötigen Werkzeuge für Docker.“
|
||
Befehle im Bild:
|
||
```
|
||
apt update && apt upgrade -y
|
||
apt install -y curl ca-certificates gnupg lsb-release docker.io docker-compose-plugin
|
||
mkdir -p /srv/wiki
|
||
cd /srv/wiki
|
||
```
|
||
|
||
---
|
||
|
||
4. Projektdateien anlegen
|
||
Szene: Terminal, Nano-Editor.
|
||
Voiceover:
|
||
„Als Nächstes legen wir die Konfigurationsdateien an. Zuerst die `.env` mit den Zugangsdaten und Einstellungen.“
|
||
Einblendung `.env`:
|
||
```
|
||
TZ=Europe/Berlin
|
||
POSTGRES_DB=wikidb
|
||
POSTGRES_USER=wikijs
|
||
POSTGRES_PASSWORD=<STARKES-PASSWORT>
|
||
```
|
||
Voiceover-Ergänzung: „Das Passwort ersetzt ihr durch ein eigenes, sicheres.“
|
||
|
||
Dann:
|
||
„Jetzt schreiben wir das Compose-File. Darin definieren wir zwei Container: Postgres als Datenbank und Wiki.js als Weboberfläche.“
|
||
Einblendung Auszug `docker-compose.yaml`.
|
||
|
||
---
|
||
|
||
5. Container starten & prüfen
|
||
Szene: Terminal.
|
||
Voiceover:
|
||
„Mit Docker Compose starten wir beide Container und prüfen, ob alles läuft.“
|
||
Befehle im Bild:
|
||
```
|
||
docker compose up -d
|
||
docker compose ps
|
||
```
|
||
Einblendung: beide Container `Up`, Postgres `healthy`.
|
||
|
||
---
|
||
|
||
6. Proxy Host einrichten
|
||
Szene: Nginx Proxy Manager Oberfläche.
|
||
Voiceover:
|
||
„Damit das Wiki über unsere Domain erreichbar ist, legen wir im Nginx Proxy Manager einen Proxy Host an: Domain eintragen, Port 3000 weiterleiten, SSL-Zertifikat erstellen – fertig.“
|
||
|
||
---
|
||
|
||
7. Erstkonfiguration im Browser
|
||
Szene: Browser → https://wiki.deinedomain.tld
|
||
Voiceover:
|
||
„Im Browser öffnen wir jetzt unser Wiki. Wir legen einen Admin-Benutzer an, stellen die Sprache auf Deutsch und die Zeitzone auf Europe/Berlin.
|
||
Für die Registrierung wählen wir Einladung oder Freigabe durch den Admin.
|
||
Zum Schluss legen wir die Startseite an – und unser Wiki ist einsatzbereit.“
|
||
|
||
---
|
||
|
||
8. Fehlerbehebung (kurz)
|
||
Szene: Terminal mit Logs.
|
||
Voiceover:
|
||
„Falls etwas nicht klappt: Mit `docker logs -f wikijs` oder `docker logs -f wiki-postgres` könnt ihr die Fehlermeldungen sehen.
|
||
Oft liegt es an falschen Passwörtern oder vergessenen Einstellungen im Proxy Manager.“
|
||
|
||
---
|
||
|
||
9. Fazit & Ausblick
|
||
Szene: Wiki-Dashboard mit Startseite.
|
||
Voiceover:
|
||
„Damit läuft Wiki.js in unserem Homelab.
|
||
Wir haben eine zentrale Plattform für Dokumentation und Wissen, die jederzeit verfügbar ist.
|
||
Im nächsten Kapitel kümmern wir uns um Monitoring mit Netdata – damit wir unsere Container im Blick behalten.“
|
||
|
||
---
|
||
|
||
🎵 Outro
|
||
Szene: Bratonien Tech Outro / Logo.
|
||
Voiceover:
|
||
„Das war Kapitel 16 – Wiki.
|
||
Wenn dir dieses Video gefallen hat, abonniere Bratonien Tech und schau dir auch die anderen Kapitel an.
|
||
Bis zum nächsten Mal – in Bratonien!“ |