# 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)
```powershell
docker-compose build --no-cache wiki
```

### 2. Alle Services bauen
```powershell
docker-compose build
```

### 3. Services starten
```powershell
docker-compose up -d
```

### 4. Logs prüfen
```powershell
# 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
```powershell
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
```powershell
docker ps -a
docker-compose logs wiki --tail=100
```

### Option 2: In Container einsteigen und manuell testen
```powershell
# 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
```powershell
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