Auch verfügbar in: 🇬🇧 English

Unraid-Installation

Zuletzt aktualisiert: 02.05.2026

Inhalt

🇬🇧 English Version

Community Apps (empfohlen)

Die einfachste Methode zur Installation von ITSWEBER Play auf Unraid ist das Community-Apps-Plugin.

  1. Die Unraid-Web-UI öffnen und den Tab Apps aufrufen.
  2. Nach ITSWEBER Play suchen.
  3. Auf der Karte von ITSWEBER Play Installieren klicken.
  4. Der Template-Editor öffnet sich. Folgende Felder konfigurieren:
Variable Standard Beschreibung
BASE_URL http://tower:3000 Öffentliche URL der Instanz. Bei Betrieb hinter einem Reverse Proxy die echte Domain angeben.
INITIAL_ADMIN_EMAIL (eigene E-Mail) E-Mail-Adresse für das Admin-Konto, das beim ersten Start angelegt wird.
Host Port 3000 Port am Unraid-Host, der auf Port 3000 des Containers gemappt wird.
  1. Auf Übernehmen klicken. Unraid lädt das Image herunter und startet den Container.

Manuelle Template-Installation

Falls ITSWEBER Play im Community-Apps-Store noch nicht verfügbar sein sollte, kann das Template manuell installiert werden:

  1. itsweber-play.xml aus dem GitHub-Repository herunterladen.
  2. Die Datei nach /boot/config/plugins/dockerMan/templates-user/ auf dem Unraid-Server kopieren.
  3. Im Tab Docker → Container hinzufügen — das ITSWEBER-Play-Template erscheint nun in der Template-Auswahl.
  4. Die Konfiguration wie oben beschrieben vornehmen.

Datenpersistenz

Alle Anwendungsdaten (Datenbank, Videodateien, Thumbnails, Konfiguration) werden im Container unter /data gespeichert. Unraid mappt diesen Pfad standardmäßig auf die Appdata-Freigabe:

/mnt/user/appdata/itsweber-play/

Diesen Ordner niemals löschen — er enthält die Postgres-Datenbank und den gesamten MinIO-Objektspeicher. Regelmäßige Backups werden empfohlen; dafür können die eingebauten Backup-Werkzeuge von Unraid oder die Skripte im Verzeichnis scripts/ des Repositories genutzt werden.

Erster Start

Nach dem Start des Containers (20–30 Sekunden für die Initialisierung der internen Services einplanen):

  1. Im Browser zu http://[unraid-ip]:3000 navigieren.
  2. Der Einrichtungsassistent führt durch die Erstellung des Admin-Kontos und die grundlegende Instanzkonfiguration.

Aktualisieren

ITSWEBER Play verwendet den Tag :main, der stets dem aktuellen stabilen Release folgt.

  1. Im Unraid-Tab Docker den Container itsweber-play anklicken.
  2. Update suchen auswählen.
  3. Bei verfügbarem Update auf Aktualisieren klicken.

Der Container startet mit dem neuen Image neu. Prisma-Migrationen laufen automatisch beim Hochfahren — kein manueller Eingriff erforderlich.

Reverse Proxy

Für HTTPS und einen sauberen Domainnamen sollte ITSWEBER Play hinter einem Reverse Proxy betrieben werden.

Nginx Proxy Manager

Einen neuen Proxy-Host anlegen:

  • Domainname: play.example.com
  • Schema: http
  • Ziel-Hostname: [unraid-ip]
  • Ziel-Port: 3000
  • Häufige Exploits blockieren und Websockets-Unterstützung aktivieren
  • Im Tab SSL ein Let's-Encrypt-Zertifikat anfordern

BASE_URL=https://play.example.com im Container-Template setzen und den Container neu starten.

Traefik (Unraid Community Traefik Plugin)

Diese Labels über das Feld "Zusätzliche Parameter" zum Container hinzufügen:

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