Docker-Installation

docker-compose.yml

Eine Datei docker-compose.yml mit folgendem Inhalt anlegen:

services:
  play:
    image: ghcr.io/itsweber-official/itsweber-play:main
    container_name: itsweber-play
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - play-data:/data
    environment:
      PUBLIC_URL: "https://play.example.com"
      NEXT_PUBLIC_SITE_URL: "https://play.example.com"
      AUTH_SECRET: "<openssl rand -hex 32>"
      POSTGRES_PASSWORD: "<openssl rand -hex 24>"
      DATABASE_URL: "postgresql://play:<POSTGRES_PASSWORD>@127.0.0.1:5432/itsweber_play"
      MINIO_ROOT_USER: "play-admin"
      MINIO_ROOT_PASSWORD: "<openssl rand -hex 24>"
      S3_ACCESS_KEY: "play-admin"
      S3_SECRET_KEY: "<gleicher Wert wie MINIO_ROOT_PASSWORD>"
      INITIAL_ADMIN_EMAIL: "admin@example.com"

volumes:
  play-data:

PUBLIC_URL und NEXT_PUBLIC_SITE_URL durch die eigene öffentliche URL ersetzen, die Platzhalter mit selbst erzeugten Werten füllen und INITIAL_ADMIN_EMAIL mit der eigenen E-Mail-Adresse belegen. INITIAL_ADMIN_EMAIL ist optional und belegt das Admin-Feld im Einrichtungsassistenten vor. SMTP wird nicht per Umgebungsvariable gesetzt, sondern im Assistenten oder unter /admin/settings. Weitere Variablen stehen unter Konfiguration.

Starten

docker compose up -d

Der Container startet alle internen Services via s6-overlay. Beim ersten Start bis zu etwa 90 Sekunden einplanen, während Postgres initialisiert und Prisma-Migrationen durchlaufen.

Logs

docker compose logs -f play

Die Logs aller internen Services landen gesammelt in docker compose logs. Den Status eines einzelnen Service zeigt s6-svstat.

docker compose exec play s6-svstat /run/service/api

Stoppen / Entfernen

docker compose down


docker compose down -v

Reverse-Proxy-Konfigurationen

HTTPS ist für den Produktionsbetrieb erforderlich. ITSWEBER Play auf Port 3000 betreiben und die TLS-Terminierung am Reverse Proxy vornehmen.

Nginx

server {
    listen 443 ssl;
    server_name play.example.com;

    ssl_certificate     /etc/letsencrypt/live/play.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/play.example.com/privkey.pem;

    client_max_body_size 0;  # Grosse Video-Uploads zulassen

    location / {
        proxy_pass         http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

Traefik

Diese Labels dem play-Service in der Compose-Datei hinzufügen:

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.play.rule=Host(`play.example.com`)"
  - "traefik.http.routers.play.entrypoints=websecure"
  - "traefik.http.routers.play.tls.certresolver=letsencrypt"
  - "traefik.http.services.play.loadbalancer.server.port=3000"

Bei Verwendung von Traefik das ports-Mapping aus der Compose-Datei entfernen.

Caddy

play.example.com {
    reverse_proxy localhost:3000 {
        header_up X-Forwarded-Proto {scheme}
    }
}

Caddy regelt HTTPS automatisch über Let's Encrypt.

HTTPS

HTTPS wird für jeden Produktionsbetrieb dringend empfohlen:

• Ohne HTTPS gehen Video-Uploads und Session-Cookies unverschlüsselt über die Leitung.
• Session-Cookies mit SameSite=Lax verhalten sich nur über HTTPS korrekt.
• PUBLIC_URL dient als erlaubter Origin für CORS und Better Auth und sollte deshalb mit https:// beginnen.

PUBLIC_URL und NEXT_PUBLIC_SITE_URL auf die https://-URL setzen und den Container nach der TLS-Konfiguration am Reverse Proxy neu starten.

Updates

docker compose pull
docker compose up -d

Der Container führt Prisma-Migrationen beim Start automatisch aus. Manuelle Datenbankschritte zwischen Versionen sind nicht erforderlich.