Medienserver in Portainer als Stack betreiben

Quven Server läuft in Portainer als gewöhnlicher Stack, der aus der offiziellen Compose-Datei entsteht. Dies ist die Fassung Nur Server: Sie hat keinen Desktop-Client und stellt die Web-App nicht bereit. Die folgenden Schritte wurden mit Portainer CE 2.45 und einer lokalen Docker-Umgebung unter Linux ausgeführt.

Voraussetzungen

Anforderung	Was Quven erwartet
Portainer	Community oder Business Edition, die eine eigenständige Docker-Umgebung verwaltet
Host	Linux auf AMD64 oder ARM64, mit Docker Engine. Docker Desktop wird nicht unterstützt
Netzwerk	Host-Netzwerk, das die Compose-Datei bereits anfordert
Mediathek	Ein Ordner, in den der Benutzer des Containers, uid 10001, schreiben kann, oder ein schreibgeschützter Mount

Die Docker-Anleitung nutzt dasselbe Image über die Befehlszeile, mit den GPU-Profilen und der Signaturprüfung.

1. Stack anlegen

1. Öffnen Sie Stacks, dann Add stack, und nennen Sie ihn quven.

2. Wählen Sie Web editor und fügen Sie die offizielle Compose-Datei vollständig ein:

   curl -fsSL https://quven.tv/docker/1.5.10/compose.yaml

3. Klicken Sie unter Environment variables auf Add an environment variable und setzen Sie QUVEN_MEDIA_DIR auf den absoluten Pfad Ihrer Mediathek auf dem Host, zum Beispiel /srv/media.

4. Klicken Sie auf Deploy the stack.

Belassen Sie das Image auf latest: Jede Version behebt Probleme, die in den früheren gefunden wurden, und eine festgehaltene Version behält sie alle.

2. Prüfen, ob er antwortet

Der Container heißt quven-quven-1. Sein Status wechselt auf healthy, sobald die Prüfung des Servers gelingt, meist innerhalb von zwei Minuten, und der Server antwortet auf Port 5181 des Hosts:

curl --fail --silent --show-error http://127.0.0.1:5181/health/container -o /dev/null

Es muss kein Port veröffentlicht werden, da das Host-Netzwerk den Server auf die Adresse des Rechners selbst legt. Eine leere Seite unter http://<server-ip>:5181 bedeutet, dass der Server läuft.

3. Konto verknüpfen

Öffnen Sie Containers, dann quven-quven-1, dann Console, verbinden Sie sich mit /bin/sh und führen Sie aus:

/app/Quven.Local.Server account link

Öffnen Sie die ausgegebene URL, melden Sie sich bei Ihrem Quven-Konto an und bestätigen Sie den Server. Native Clients finden ihn im LAN, und mit Pro erreicht ihn app.quven.tv zusätzlich über das verwaltete Relay.

4. Mediathek hinzufügen

Fügen Sie Mediatheken über die Desktop-App von Quven auf einem beliebigen Computer im selben Netzwerk hinzu oder mit Pro über app.quven.tv. Wählen Sie Ordner unterhalb von /media: Eine Mediathek des Hosts unter /srv/media erscheint in Quven als /media.

Optionale Variablen

Variable	Standard	Was sie ändert
QUVEN_MEDIA_READ_ONLY	false	true bindet die Mediathek schreibgeschützt ein; Untertitel bleiben in Quven
QUVEN_DATA_VOLUME	quven-data	Das Volume mit Datenbank, Einstellungen und Protokollen
QUVEN_TMPFS_SIZE	4g	Zwischenspeicher für Transkription und das Lesen von Untertiteln
QUVEN_URLS	http://0.0.0.0:5181	Adresse und Port, auf denen der Server lauscht

Quven schreibt die Untertitel, die es erzeugt, neben den Film, wofür der Ordner für uid 10001 beschreibbar sein muss. Mit QUVEN_MEDIA_READ_ONLY auf true behält es sie stattdessen in seinem eigenen Volume.

Update

1. Öffnen Sie den Stack quven und seinen Reiter Editor.
2. Klicken Sie auf Update the stack und aktivieren Sie Re-pull image and redeploy.
3. Bestätigen Sie mit Update.

Das Volume quven-data übersteht das Update, sodass Mediathek, Wiedergabeverlauf und Kontoverknüpfung erhalten bleiben. Kopieren Sie das Volume vor einer Version, zu der Sie zurückkehren möchten, denn ein älteres Image liest keine Datenbank, die ein neueres bereits migriert hat.

Häufig gestellte Fragen