LiveWorker einrichten
Optionalen Worker für Live-Untertitel installieren und prüfen.
Der LiveWorker ergänzt einen eingerichteten Livestream um automatische Untertitel und gegebenenfalls Übersetzung. Diese Anleitung setzt das vorhandene Installationspaket voraus; die öffentliche Veröffentlichung ist noch in Vorbereitung.
Voraussetzungen
- Erreichbare Sermony-Instanz über HTTPS und eingerichteter Livestream.
- Docker Compose auf dem Worker-Server.
- Für die mitgelieferte GPU-Konfiguration: NVIDIA-GPU, passender Treiber und NVIDIA Container Toolkit.
- Genügend Speicher für die verwendeten Modelle und deren Downloads.
Prüfe den Treiber:
nvidia-smi
Installiere das Toolkit nach der NVIDIA-Anleitung. Die anschließende Docker-Konfiguration erfolgt mit:
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
Der Docker-Neustart kann andere laufende Container unterbrechen. Plane diesen Schritt vor der Nutzung ein.
Installation
Öffne Einstellungen → System → Worker und wähle Worker hinzufügen. Sichere den einmalig angezeigten API-Schlüssel für den LiveWorker. Verwende hierfür keinen Recorder-Token.
cd /pfad/zum/entpackten/sermony-selfhosted
less deploy/liveworker/setup.sh
sudo bash ./install.sh liveworker
Gib die HTTPS-Adresse der Sermony-Instanz und den Worker-API-Schlüssel ein. Der Installer legt die Dateien unter /opt/sermony-liveworker ab.
Die wichtigsten Einstellungen:
SERMONY_URL=https://sermony.example.com
SERMONY_WORKER_API_KEY=SCHLUESSEL_AUS_DER_WORKER_VERWALTUNG
TZ=Europe/Berlin
Trage echte Werte in die vom Installer erzeugte Datei ein; ersetze nicht deren gesamten Inhalt durch diesen Ausschnitt.
Start und Diagnose
cd /opt/sermony-liveworker
sudo docker compose --env-file .env config --quiet
sudo docker compose ps
sudo docker compose logs --tail=100 liveworker
Prüfe in der Worker-Verwaltung, ob die Verbindung besteht. Starte anschließend einen Teststream mit aktivierten Untertiteln und kontrolliere die Ausgabe im Player.
| Problem | Prüfung |
|---|---|
| Kein GPU-Zugriff | Funktioniert nvidia-smi auf dem Host, und ist die Docker-Runtime eingerichtet? |
| Anmeldung abgelehnt | SERMONY_URL und SERMONY_WORKER_API_KEY abgleichen |
| Erster Einsatz dauert lange | Modell-Download und freien Speicher in den Logs prüfen |
| Arbeitsspeicher oder GPU-Speicher erschöpft | Verarbeitung beenden; Modell- und Parallelitätseinstellungen an die verfügbare Hardware anpassen |
| Keine Untertitel trotz Verbindung | Aktiven Stream, Zuordnung des Workers und aktivierte Untertitel prüfen |
Es gibt noch keine verifizierten Leistungszusagen pro GPU oder feste Latenzwerte. Teste mit eurer Sprache, dem tatsächlichen Tonsignal und den geplanten gleichzeitigen Streams. Automatisch erzeugte Texte können Fehler enthalten.
Updates
cd /opt/sermony-liveworker
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps
Updates außerhalb laufender Übertragungen durchführen. Die GPU-Konfiguration gehört zum Paket; ein CPU-Betrieb erfordert Anpassungen daran und ist keine zugesagte Echtzeit-Alternative.