Schnellstart

In 3 Minuten betriebsbereit.

Voraussetzungen

• Docker und Docker Compose auf dem Host installiert
• Port 3000 frei und erreichbar
• Funktionierende Internetverbindung (zum Pullen des Images von GHCR)

Ein-Liner (Docker)

PG_PASS=$(openssl rand -hex 24)
MINIO_PASS=$(openssl rand -hex 24)

docker run -d \
  --name itsweber-play \
  -p 3000:3000 \
  -v play-data:/data \
  -e PUBLIC_URL=http://localhost:3000 \
  -e NEXT_PUBLIC_SITE_URL=http://localhost:3000 \
  -e AUTH_SECRET=$(openssl rand -hex 32) \
  -e POSTGRES_PASSWORD=$PG_PASS \
  -e DATABASE_URL=postgresql://play:$PG_PASS@127.0.0.1:5432/itsweber_play \
  -e MINIO_ROOT_USER=play-admin \
  -e MINIO_ROOT_PASSWORD=$MINIO_PASS \
  -e S3_ACCESS_KEY=play-admin \
  -e S3_SECRET_KEY=$MINIO_PASS \
  -e INITIAL_ADMIN_EMAIL=admin@example.com \
  ghcr.io/itsweber-official/itsweber-play:main

Dieser Befehl lädt den aktuellen Build des main-Branches herunter, startet alle internen Services (Postgres, Redis, MinIO, API, Worker, Web, Nginx) innerhalb eines einzigen Containers und speichert alle persistenten Daten im Docker-Volume play-data.

Im Browser öffnen

Zu http://localhost:3000 navigieren.

Beim ersten Aufruf leitet die Instanz automatisch auf /setup zum Einrichtungsassistenten um. Das passiert so lange, bis der Assistent einmal abgeschlossen wurde, unabhängig davon, ob schon ein Konto existiert.

Schritte des Einrichtungsassistenten

1. Sprache — Deutsch oder English als Oberflächensprache wählen.
2. Site-Name — Namen, Tagline und optional eine Kontakt-E-Mail setzen.
3. Branding — Ein eigenes Logo hochladen oder den Schritt überspringen.
4. Admin-Account — Das Admin-Konto anlegen. Ist INITIAL_ADMIN_EMAIL gesetzt, ist die E-Mail-Adresse vorbelegt und gesperrt.
5. E-Mail (SMTP) — Optional den Mailserver für Passwort-Reset und Benachrichtigungen eintragen.
6. Theme — Ein mitgeliefertes Preset wählen.
7. Registrierung — Offen, nur per Einladung oder geschlossen.
8. Storage — Hinweise zu Volumes, Backups und Reverse Proxy bestätigen.
9. Fertig — Zusammenfassung prüfen und abschließen.

Einen Kanal musst du nicht anlegen, jedes Konto bekommt bei der Registrierung automatisch einen Standardkanal. Nach Abschluss des Assistenten geht es direkt ins Admin-Panel unter /admin.

Wie geht es weiter?

Produktionshinweis

Der obige Ein-Liner eignet sich für lokale Tests. Für einen Produktionsbetrieb gilt:

• PUBLIC_URL und NEXT_PUBLIC_SITE_URL auf die echte öffentliche URL setzen (z. B. https://play.example.com)
• E-Mail-Versand im Einrichtungsassistenten oder später unter /admin/settings einrichten, damit Passwort-Reset und Benachrichtigungen funktionieren. SMTP-Daten liegen in der Datenbank, SMTP_*-Umgebungsvariablen gibt es nicht.
• Den Container hinter einem Reverse Proxy (Nginx, Traefik, Caddy) betreiben, der die TLS-Terminierung übernimmt
• HTTPS wird dringend empfohlen — Browser-Upload-APIs und Session-Cookies erfordern für volle Funktionalität einen sicheren Kontext

Eine vollständige Liste aller Umgebungsvariablen findet sich unter Konfiguration.