コミュニティソリューション

ZimaOSでJellyfinのタイムゾーンを修正:TZ環境変数をIANA地域に設定する

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.

問題の解決策はシンプルで公式なものでした。Jellyfinはコンテナ環境変数 TZ=Europe/London でインストールされていましたが、ユーザーは米国在住でした。Zima-Jerryは、値を America/New_York などの適切なIANAタイムゾーン識別子に置き換えるよう案内しました。ユーザーが変更したところ、すぐに動作したことを確認しました。

これはコンテナ設定の問題であり、Jellyfinを再インストールしたり、ZimaOSホストのシステム時刻を変更したりする必要はありません。現在のJellyfinコンテナ例でも、America/Los_Angeles のような地域形式の値を指定する TZ 環境変数が引き続き使用されています。

TZ環境変数がEurope/Londonに設定されたZimaOS Jellyfinアプリ設定
問題の原因はアプリ設定で直接確認できます。JellyfinのコンテナTZが誤った地域に設定されていました。

TZ環境変数を変更する

ZimaOSでJellyfinのアプリ設定を開き、TZという名前の環境変数を見つけ、値を正しいIANA地域/都市識別子に置き換えます。

例:

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

固定のUTCオフセットではなく、地域/都市名を使用する

IANAタイムゾーンは、夏時間への移行や過去のルール変更を認識します。UTC-5のような固定値は、夏時間を採用している地域では年間の一部期間に正しくない場合があります。

アプリ設定を保存し、コンテナを再起動させる

環境変数はコンテナの起動時に適用されます。TZを変更したら、アプリ設定を保存し、ZimaOSの要求に従ってJellyfinが再起動または再作成されるまで待ちます。

その後、Jellyfinのログ、スケジュールタスク、日付に依存するUIで時刻を確認します。

1つのコンテナを直すためだけにZimaOSのシステム時刻を変更しない

ZimaOSのダッシュボードがすでに正しい時刻を表示しているのにJellyfinだけが正しくない場合は、まずJellyfinのコンテナタイムゾーンを変更してください。ホストのNTP/時刻設定と、コンテナ内で表示される時刻は別の層です。

元のカスタムポートマッピングはTZの修正とは関係ない

8097から8096へのマッピングを含むホストとコンテナ間のポートマッピングを示すZimaOS Jellyfinアプリ設定
元の設定にはカスタムポートもありましたが、Zima-Jerryはそれらのマッピングを誤ったタイムゾーンの原因として特定していません。

GPUデバイスのマッピングはJellyfinの別の問題

/dev/driを含むGPUおよびビデオデバイスのマッピングを示すZimaOS Jellyfin設定
ハードウェアトランスコード用デバイスはTZ環境変数に影響しません。別途トラブルシューティングしてください。

現在のJellyfin Docker例でも同じTZパターンを使用している

Jellyfinの現在のコンテナドキュメントには、次のような環境設定が含まれています。

TZ=America/Los_Angeles

現在のJellyfinコンテナ環境のパターンを参照してください。

時刻が表示以外でも重要な理由

Jellyfinは、ログ、スケジュールされたメンテナンス、ライブラリタスク、アクティビティ履歴など、日付に依存するさまざまな動作で時刻情報を使用します。そのため、TZの値が間違っていると、メディア再生自体は正常でも、サーバーの動作が分かりにくくなることがあります。

変数を変更した後は、少なくとも1件のスケジュールタスクのタイムスタンプまたは最近のログエントリを確認し、ブラウザだけでなくコンテナ自体が意図したタイムゾーンを認識していることを確認してください。

Jellyfinのタイムゾーンに関するよくある質問

TZを変更すると、元のユーザーの問題は解決しましたか?

はい。ユーザーは明確に、問題が解決したと返信しています。

値にはESTやPSTを指定すべきですか?

夏時間のルールが正しく処理されるよう、America/New_YorkAmerica/Los_Angeles などのIANA地域を優先してください。

タイムゾーンを修正するために、JellyfinのポートやGPU設定を変更する必要はありますか?

いいえ。これらの設定はTZ環境変数とは別のものです。