ユーザーや履歴を失わずにJellyfinを移行するには、永続データをコピーする前に移行元を停止し、移行先が検証に合格するまで元のインスタンスをそのまま維持します。
すべてのメディアファイルが存在していても、ホームサーバーの移行に失敗することがあります。Jellyfinの状態はデータ、設定、メタデータ、データベースの各パスに保存されているためです。これらのマウントを一覧化し、書き込みを停止した状態でコピーして、同じパスと所有者を再作成します。その後、移行元を廃止する前に、ログイン、履歴、ライブラリへのアクセス、再生をテストします。
移行元を停止し、永続パスを一覧化する
移行元のインスタンスはまだユーザーにサービスを提供しています。まずは影響の少ない確認から始めます。Jellyfinのデータ、設定、キャッシュのパス、コンテナのマウント、UID/GID、バージョン、メディアの場所を記録し、状態をコピーする前にコンテナを停止します。
確認すべき内容は具体的です。すべての状態パスがマウントされているか、データベースのパスがボリューム内に隠れていないか、メディアだけがマッピングされていないかを確認します。別の変数を変更する前に結果を記録してください。移行前にバックアップ
推測せず、分岐に沿って判断します。すべての永続パスが把握できている場合は続行します。パスが隠れている場合は、まず解決します。メディアだけがマッピングされている場合は、コピーする前に状態のバックアップを作成します。
所有権を維持したままデータ、設定、データベースをコピーする
移行元は停止され、パスの一覧化も完了しています。まずは影響の少ない確認から始めます。状態ディレクトリを先にコピーし、ファイル数とサイズを比較してから、移行先のUID/GIDを適用し、Jellyfinがデータベースを読み書きできることを確認します。
確認すべき内容は具体的です。データベースが正常に開くか、権限拒否が表示されるか、パスは存在するもののライブラリが空になっていないかを確認します。別の変数を変更する前に結果を記録してください。ローカルデータベースのパス
推測せず、分岐に沿って判断します。データベースが開き、パスが一致している場合は続行します。権限エラーが発生した場合は、ファイルを削除せずに所有権を修正します。ライブラリが空の場合は、再スキャンする前にマウントパスを修正します。
結果をテストする前に実行環境を再作成する
永続データのコピーと所有権の修正が完了しています。まずは影響の少ない確認から始めます。移行先のマウントを指定してコンテナを再作成し、イメージのバージョンを記録します。ライブラリやユーザーを変更する前に、管理ダッシュボードを開いてください。
確認すべき内容は具体的です。ユーザーとライブラリが表示されるか、起動時の移行処理が実行されるか、初期セットアップウィザードが表示されるかを確認します。別の変数を変更する前に結果を記録してください。
推測せず、分岐に沿って判断します。状態が表示される場合は、まだ再スキャンしないでください。移行処理が実行された場合は、完了するまで待ち、移行元を維持します。セットアップウィザードが表示された場合は、データマウントが間違っているため停止します。
クリーンアップ前にユーザー、履歴、ライブラリ、再生を確認する
新しいインスタンスはコピーした状態で起動しています。まずは影響の少ない確認から始めます。既存ユーザーとしてログインし、視聴履歴とライブラリの権限を確認します。次に、ダイレクト再生を1本、トランスコードを1本再生してから、1回再起動し、同じ確認を繰り返します。
確認すべき内容は具体的です。すべての状態と再生が正常か、1つのライブラリが空になっていないか、ユーザーや履歴が欠落していないかを確認します。別の変数を変更する前に結果を記録してください。移行の検証手順
推測せず、分岐に沿って判断します。すべての確認に2回合格した場合は、最終バックアップを保持し、後日移行元を廃止します。状態に関する確認が1つでも失敗した場合は、クライアントを移行元に戻します。再生に失敗した場合は、クリーンアップ前にパスまたはアクセラレーターを修正します。
サポートとヒント
もっと読む

Jellyfinは別のコンテナとGPUやアクセラレーターを安全に共有できますか?
GPUの共有には条件があります。デバイスが認識され、ドライバーが対応していることを確認してから、両方のワークロードを実行し、ソフトウェアフォールバックが発生していないか監視してください。

Jellyfinのエラーがクライアントとサーバーのどちらに起因するかを見分ける方法
Jellyfinのエラーが特定の1台のデバイスにだけ発生する場合はクライアント側に原因があり、同じ経路で複数のクライアントが失敗し、ログも一致する場合はサーバー側に原因があります。

Jellyfinのキャッシュと一時ストレージの設定方法
永続的なデータ、再構築可能なキャッシュ、一時的なトランスコード用ストレージを分離し、実際に再生テストを行って容量と権限を確認します。

