# Quartz Setup auf dem Server

## Übersicht

Diese Anleitung beschreibt, wie Sie Quartz als separate Instanz auf Port 3033 auf Ihrem Server einrichten.

## Optionen für Quartz-Instanz

### Option 1: Quartz direkt auf dem Host (Empfohlen)

Quartz läuft direkt auf dem Server-Host auf Port 3033:

```bash
# Quartz starten
cd /path/to/quartz
npx quartz build
npx serve -s public -l 3033
```

**Konfiguration:** `NEXT_PUBLIC_WIKI_URL=http://localhost:3033`

### Option 2: Quartz in separatem Docker-Container

Quartz läuft in einem eigenen Container:

```yaml
# docker-compose.wiki.yml
services:
  quartz:
    image: your-quartz-image
    ports:
      - "3033:3033"
    volumes:
      - ./wiki-vault:/app/content
      - ./wiki-public:/app/public
```

**Konfiguration:** 
- Für Browser (iframe): `NEXT_PUBLIC_WIKI_URL=http://localhost:3033`
- Falls Next.js-Container zugreift: `NEXT_PUBLIC_WIKI_URL=http://host.docker.internal:3033`

### Option 3: Quartz im Docker-Netzwerk

Beide Container im gleichen Netzwerk:

```bash
# Netzwerk erstellen
docker network create wiki-network

# Next.js Container
docker-compose up -d
docker network connect wiki-network doing-it-web-1

# Quartz Container
docker run -d --name quartz --network wiki-network -p 3033:3033 your-quartz-image
```

**Konfiguration:** `NEXT_PUBLIC_WIKI_URL=http://quartz:3033`

## Wichtiger Hinweis

Da das iframe **client-side** im Browser läuft (nicht im Container), verwendet es die URL so wie sie gesetzt ist:
- **`localhost:3033`** funktioniert, wenn Quartz auf dem Host läuft
- **`host.docker.internal:3033`** funktioniert nur von einem Container aus, NICHT vom Browser
- Für Browser muss die **öffentliche URL** verwendet werden (z.B. `http://doing-it.de:3033` oder über Reverse Proxy)

## Reverse Proxy Setup (Empfohlen für Produktion)

### Mit Nginx

```nginx
server {
    listen 80;
    server_name wiki.doing-it.de;

    location / {
        proxy_pass http://localhost:3033;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

**Dann:** `NEXT_PUBLIC_WIKI_URL=http://wiki.doing-it.de`

### Oder Subpath

```nginx
server {
    listen 80;
    server_name doing-it.de;

    location /wiki-content/ {
        proxy_pass http://localhost:3033/;
    }
}
```

## Environment-Variable setzen

### In docker-compose.yml (bereits konfiguriert)

```yaml
environment:
  - NEXT_PUBLIC_WIKI_URL=${NEXT_PUBLIC_WIKI_URL:-http://localhost:3033}
```

### In .env Datei

```bash
NEXT_PUBLIC_WIKI_URL=http://localhost:3033
```

### Bei Container-Start

```bash
NEXT_PUBLIC_WIKI_URL=http://localhost:3033 docker-compose up -d
```

## Testing

1. Quartz starten auf Port 3033
2. Prüfen: `curl http://localhost:3033`
3. Next.js starten
4. Wiki-Seite öffnen: `http://localhost:3001/wiki`
5. Browser-Entwicklertools (F12) öffnen und prüfen, ob iframe geladen wird