doing-it-website/DEBUG-WIKI.md

Debug-Anleitung für Wiki-Setup

Problem behoben: Node.js Version

Problem: Quartz 4.5.2 benötigt Node.js >= 22, wir hatten Node 20.

Lösung: Dockerfile wurde aktualisiert auf node:22-alpine

Build-Anweisungen

1. Wiki-Service neu bauen (nach Node.js Update)

docker-compose build --no-cache wiki

2. Alle Services bauen

docker-compose build

3. Services starten

docker-compose up -d

4. Logs prüfen

# Alle Logs
docker-compose logs

# Nur Wiki-Logs
docker-compose logs wiki

# Live-Logs folgen
docker-compose logs -f wiki

5. Container-Status prüfen

docker-compose ps

Erwartete Ausgabe beim Build

Beim erfolgreichen Build sollten Sie sehen:

• ✅ Git wird installiert
• ✅ npm wird aktualisiert
• ✅ Quartz Repository wird geklont
• ✅ npm install läuft durch (kann einige Minuten dauern)
• ✅ serve wird installiert

Wenn der Build immer noch fehlschlägt

Option 1: Container-Status prüfen

docker ps -a
docker-compose logs wiki --tail=100

Option 2: In Container einsteigen und manuell testen

# Container starten (auch wenn Build fehlschlägt)
docker-compose run --rm wiki sh

# Dann im Container:
cd /app/quartz-repo
npm install

Option 3: Cache leeren und neu bauen

docker-compose down
docker system prune -f
docker-compose build --no-cache wiki

Erwartete Ports

• Web (Next.js): http://localhost:3001
• Wiki (Quartz): http://localhost:8080

Nächste Schritte nach erfolgreichem Build

1. Services starten: docker-compose up -d
2. Wiki aufrufen: http://localhost:8080
3. Wiki-Seite testen: http://localhost:3001/wiki