Community-Lösung

Zeitzone von Jellyfin auf ZimaOS korrigieren: Die Umgebungsvariable TZ auf eine IANA-Region festlegen

A short November 2025 support thread where a new Jellyfin user in the United States saw TZ set to Europe/London. Zima-Jerry said to change the TZ environment variable to a valid region such as America/New_York. The original poster immediately confirmed the change worked.

Die Lösung des ursprünglichen Problems ist einfach und offiziell: Jellyfin wurde mit der Container-Umgebungsvariable TZ=Europe/London installiert, der Benutzer lebte jedoch in den Vereinigten Staaten. Zima-Jerry empfahl, den Wert durch eine passende IANA-Zeitzonenkennung wie America/New_York zu ersetzen. Der Benutzer änderte den Wert und bestätigte sofort, dass es funktionierte.

Dies ist ein Problem der Containerkonfiguration und kein Grund, Jellyfin neu zu installieren oder die Systemuhr des ZimaOS-Hosts zu ändern. Aktuelle Beispiele für Jellyfin-Container verwenden weiterhin eine TZ-Umgebungsvariable mit regionsbasierten Werten wie America/Los_Angeles.

ZimaOS-Jellyfin-App-Einstellungen mit der auf Europe/London gesetzten TZ-Umgebungsvariable
Das ursprüngliche Problem ist direkt in den App-Einstellungen zu sehen: Die Container-TZ von Jellyfin war auf die falsche Region gesetzt.

Die TZ-Umgebungsvariable ändern

Öffnen Sie die App-Einstellungen von Jellyfin in ZimaOS, suchen Sie die Umgebungsvariable mit dem Namen TZ und ersetzen Sie den Wert durch die korrekte IANA-Regions-/Stadtkennung.

Beispiele:

  • America/New_York;
  • America/Chicago;
  • America/Denver;
  • America/Los_Angeles;
  • Europe/London;
  • Asia/Tokyo.

Regions-/Städtenamen statt eines festen UTC-Offsets verwenden

Eine IANA-Zeitzone berücksichtigt Zeitumstellungen und historische Regeländerungen. Ein fester Wert wie UTC-5 kann in Regionen, in denen die Sommerzeit gilt, während eines Teils des Jahres falsch sein.

App-Einstellungen speichern und den Container neu starten lassen

Umgebungsvariablen werden beim Start des Containers übernommen. Speichern Sie nach der Änderung von TZ die App-Einstellungen und lassen Sie Jellyfin entsprechend den Anforderungen von ZimaOS neu starten bzw. neu erstellen.

Prüfen Sie anschließend die Uhrzeit in den Jellyfin-Protokollen, geplanten Aufgaben und allen datumsabhängigen Bereichen der Benutzeroberfläche.

Ändern Sie die ZimaOS-Systemuhr nicht, um nur einen Container zu korrigieren

Wenn das ZimaOS-Dashboard bereits die richtige Uhrzeit anzeigt, Jellyfin jedoch nicht, ändern Sie zunächst die Zeitzone des Jellyfin-Containers. Die NTP-/Zeiteinstellungen des Hosts und die Zeitanzeige im Container sind getrennte Ebenen.

Die benutzerdefinierten Portzuordnungen des ursprünglichen Setups waren nicht Teil der TZ-Korrektur

ZimaOS-Jellyfin-App-Einstellungen mit Host-zu-Container-Portzuordnungen, darunter 8097 zu 8096
Im ursprünglichen Setup gab es außerdem benutzerdefinierte Ports, aber Zima-Jerry identifizierte diese Zuordnungen nicht als Ursache der falschen Zeitzone.

GPU-Gerätezuordnungen sind ein separates Jellyfin-Problem

ZimaOS-Jellyfin-Einstellungen mit GPU- und Videogerätezuordnungen, darunter /dev/dri
Geräte für Hardware-Transkodierung beeinflussen die TZ-Umgebungsvariable nicht; untersuchen Sie diese separat.

Aktuelle Jellyfin-Docker-Beispiele verwenden dasselbe TZ-Muster

Die aktuelle Container-Dokumentation von Jellyfin enthält Umgebungsvariablen wie:

TZ=America/Los_Angeles

Siehe das aktuelle Muster für die Containerumgebung von Jellyfin.

Warum die Zeitzone über die Uhranzeige hinaus wichtig ist

Jellyfin verwendet Zeitangaben für Protokolle, geplante Wartungsarbeiten, Bibliotheksaufgaben, den Aktivitätsverlauf und andere datumsabhängige Funktionen. Ein falscher TZ-Wert kann daher den Eindruck eines verwirrenden, aber ansonsten funktionierenden Servers erwecken, selbst wenn die Medienwiedergabe funktioniert.

Überprüfen Sie nach der Änderung der Variable mindestens den Zeitstempel einer geplanten Aufgabe oder eines aktuellen Protokolleintrags, damit Sie wissen, dass der Container – und nicht nur der Browser – jetzt die gewünschte Zeitzone verwendet.

FAQ zur Jellyfin-Zeitzone

Hat die Änderung von TZ das Problem des ursprünglichen Benutzers behoben?

Ja. Der Benutzer bestätigte ausdrücklich, dass es funktionierte.

Sollte der Wert EST oder PST sein?

Verwenden Sie vorzugsweise eine IANA-Region wie America/New_York oder America/Los_Angeles, damit die Regeln für die Sommerzeit korrekt berücksichtigt werden.

Müssen Jellyfin-Port- oder GPU-Einstellungen für die Zeitzonenkorrektur geändert werden?

Nein. Diese Einstellungen sind von der TZ-Umgebungsvariable unabhängig.