208 lines
5.6 KiB
Markdown
208 lines
5.6 KiB
Markdown
# 📝 Kapitel 16 – Wiki (Self-Hosted mit Wiki.js)
|
||
|
||
---
|
||
|
||
🎯 Ziel
|
||
Wir setzen **Wiki.js** im Debian‑12‑LXC mit Docker stabil und wiederholbar auf.
|
||
Am Ende: HTTPS‑Zugriff über Subdomain, Admin angelegt, Registrierung abgesichert.
|
||
|
||
---
|
||
|
||
📖 Warum Wiki.js?
|
||
- ✅ Moderne Weboberfläche, Markdown, Suche
|
||
- ✅ Rechte/Rollen, volle Datenhoheit im Homelab
|
||
- ✅ Leichtgewichtig per Docker betreibbar
|
||
|
||
---
|
||
|
||
✅ Voraussetzungen
|
||
- Debian 12 LXC, 1 vCPU, 1–2 GB RAM, ≥ 10 GB Speicher
|
||
- Domain/Subdomain (z. B. `wiki.deinedomain.tld`)
|
||
- Nginx Proxy Manager + DynDNS
|
||
- Internetzugang im LXC
|
||
|
||
---
|
||
|
||
## 1️⃣ System & Docker (stabile Variante über das offizielle Docker‑Repo)
|
||
|
||
**Warum:** Die Debian‑Pakete liefern kein zuverlässiges Compose‑Plugin. Wir binden das **offizielle Docker‑Repository** ein und installieren Docker + Compose einmal richtig.
|
||
|
||
```bash
|
||
apt update && apt upgrade -y
|
||
apt install -y ca-certificates curl gnupg lsb-release
|
||
```
|
||
👉 System aktualisieren, Grundpakete für HTTPS‑Repos und Schlüsselverwaltung.
|
||
|
||
```bash
|
||
mkdir -p /etc/apt/keyrings
|
||
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
|
||
```
|
||
👉 Docker‑GPG‑Schlüssel ablegen (benötigt für verifizierte Pakete).
|
||
|
||
```bash
|
||
ARCH=$(dpkg --print-architecture)
|
||
CODENAME=$(lsb_release -cs)
|
||
echo "deb [arch=${ARCH} signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian ${CODENAME} stable" \
|
||
| tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||
apt update
|
||
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||
```
|
||
👉 Repo einbinden, Paketquellen aktualisieren, **Docker + Compose‑Plugin** installieren.
|
||
|
||
```bash
|
||
systemctl enable --now docker
|
||
```
|
||
👉 Docker beim Start aktivieren und sofort starten.
|
||
|
||
```bash
|
||
mkdir -p /srv/wiki
|
||
cd /srv/wiki
|
||
```
|
||
👉 Projektordner anlegen und hineingehen – hier liegt alles zum Wiki.
|
||
|
||
---
|
||
|
||
## 2️⃣ Umgebungsdatei `.env` erstellen
|
||
|
||
**Warum:** Zugangsdaten und wiederverwendbare Einstellungen zentral halten.
|
||
|
||
```bash
|
||
nano .env
|
||
```
|
||
👉 Datei öffnen, folgenden Inhalt einfügen, **<STARKES-PASSWORT>** ersetzen, dann **STRG+O**, Enter, **STRG+X**:
|
||
|
||
```env
|
||
TZ=Europe/Berlin
|
||
POSTGRES_DB=wikidb
|
||
POSTGRES_USER=wikijs
|
||
POSTGRES_PASSWORD=<STARKES-PASSWORT>
|
||
|
||
WIKI_DB_HOST=postgres
|
||
WIKI_DB_PORT=5432
|
||
WIKI_DB_USER=${POSTGRES_USER}
|
||
WIKI_DB_PASS=${POSTGRES_PASSWORD}
|
||
WIKI_DB_NAME=${POSTGRES_DB}
|
||
WIKI_PORT=3000
|
||
```
|
||
|
||
---
|
||
|
||
## 3️⃣ `docker-compose.yaml` schreiben
|
||
|
||
**Warum:** Definiert die beiden Dienste (Datenbank + Wiki) samt Persistenz und Startreihenfolge.
|
||
|
||
```bash
|
||
nano docker-compose.yaml
|
||
```
|
||
👉 Inhalt einfügen → speichern (**STRG+O**) → schließen (**STRG+X**):
|
||
|
||
```yaml
|
||
version: "3.9"
|
||
services:
|
||
postgres:
|
||
image: postgres:15
|
||
container_name: wiki-postgres
|
||
restart: unless-stopped
|
||
env_file: .env
|
||
environment:
|
||
POSTGRES_DB: ${POSTGRES_DB}
|
||
POSTGRES_USER: ${POSTGRES_USER}
|
||
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
|
||
TZ: ${TZ}
|
||
volumes:
|
||
- ./data/postgres:/var/lib/postgresql/data
|
||
healthcheck:
|
||
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
|
||
interval: 10s
|
||
timeout: 5s
|
||
retries: 10
|
||
|
||
wikijs:
|
||
image: requarks/wiki:2
|
||
container_name: wikijs
|
||
depends_on:
|
||
postgres:
|
||
condition: service_healthy
|
||
restart: unless-stopped
|
||
env_file: .env
|
||
environment:
|
||
DB_TYPE: postgres
|
||
DB_HOST: ${WIKI_DB_HOST}
|
||
DB_PORT: ${WIKI_DB_PORT}
|
||
DB_USER: ${WIKI_DB_USER}
|
||
DB_PASS: ${WIKI_DB_PASS}
|
||
DB_NAME: ${WIKI_DB_NAME}
|
||
TZ: ${TZ}
|
||
ports:
|
||
- "3000:${WIKI_PORT}"
|
||
volumes:
|
||
- ./data/wikijs:/var/wiki
|
||
```
|
||
👉 Persistenz: `./data/postgres` (DB‑Daten) und `./data/wikijs` (Uploads/Cache). Healthcheck sorgt für korrekte Startreihenfolge.
|
||
|
||
---
|
||
|
||
## 4️⃣ Start & Status prüfen
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
👉 Beide Container im Hintergrund starten.
|
||
|
||
```bash
|
||
docker compose ps
|
||
```
|
||
👉 Status prüfen: beide `Up`; `wiki-postgres` wird nach kurzer Zeit `healthy`.
|
||
|
||
Logs bei Problemen:
|
||
```bash
|
||
docker logs -f wikijs
|
||
# in neuem Terminal/Fenster ggf. zusätzlich:
|
||
docker logs -f wiki-postgres
|
||
```
|
||
👉 Live‑Logs helfen bei DB‑Verbindungsfehlern oder Startproblemen.
|
||
|
||
---
|
||
|
||
## 5️⃣ Reverse‑Proxy im Nginx Proxy Manager
|
||
|
||
**Warum:** Öffentlich per Domain & HTTPS erreichbar machen.
|
||
|
||
1. NPM öffnen → **Proxy Host hinzufügen**
|
||
2. **Domain**: `wiki.deinedomain.tld`
|
||
3. **Forward Host/IP**: `<LXC-IP>` · **Port**: `3000`
|
||
4. **Websockets aktivieren**
|
||
5. **SSL**: Neues Zertifikat (Let’s Encrypt) → **Force SSL**, **HTTP/2**, **HSTS** aktivieren
|
||
6. Speichern
|
||
|
||
👉 Test: `https://wiki.deinedomain.tld` im Browser aufrufen.
|
||
|
||
---
|
||
|
||
## 6️⃣ Erstkonfiguration in Wiki.js
|
||
|
||
1. Admin‑Benutzer anlegen (Benutzername, Passwort, E‑Mail)
|
||
2. Sprache **Deutsch**, Zeitzone **Europe/Berlin** setzen
|
||
3. Registrierung: **Nur Einladung** oder **Admin Approval**
|
||
4. Erste **Startseite** anlegen (Projektübersicht)
|
||
|
||
👉 Danach ist das Wiki einsatzbereit.
|
||
|
||
---
|
||
|
||
## ⚠️ Fehlerbehebung (kurz & präzise)
|
||
- **502 via NPM** → Container laufen? Port 3000 korrekt? **Websockets** an?
|
||
- **Setup hängt/DB‑Fehler** → Werte in `.env` prüfen; Logs oben ansehen
|
||
- **IPv6‑Probleme** → AAAA‑Record testweise entfernen
|
||
- **Uploads fehlen** → Schreibrechte in `./data/wikijs` prüfen
|
||
|
||
---
|
||
|
||
## ✅ Ergebnis
|
||
- Wiki.js läuft stabil in Docker (Debian 12 LXC)
|
||
- Zugriff: `https://wiki.deinedomain.tld` (HTTPS)
|
||
- Admin angelegt, Registrierung eingeschränkt
|
||
- Daten persistent gespeichert
|
||
|
||
➡️ Nächstes Kapitel: **Netdata (Monitoring)**
|