# 1.12.0 マイグレーションガイド

SillyTavern 1.12.0（コードネーム"Neo Server"アップデート）には、SillyTavernの使用方法に影響を与える可能性のあるいくつかの重要な変更が含まれています。

このガイドは、更新の準備をし、さらなるガイダンスを提供します。

1.12.0は、SillyTavernがユーザーデータを処理する方法を変更します。

以前は、すべての永続データは/publicディレクトリ内のフロントエンド部分と一緒に保存されていましたが、これにより混乱と潜在的な障害ポイントが発生し、コンテナ化とシステム全体のアプリインストールが非常に困難になっていました。

/publicからのsettingsやchats（以下の完全なリスト）などのすべての永続情報は、設定可能なパスを持つ別のディレクトリに移動され、webサーバー自体から独立してポータブルになりました。互換性のために必要な場合、例えばextensionsのホスティング、フルサイズのキャラクターカード、ユーザーの画像アップロードなどの場合、dataディレクトリからユーザーファイルを自動的にホストするためのスマートリダイレクトが設定されています。

config.yamlまたはサーバーを--dataRootコンソール引数で起動することにより、data rootへの絶対パスまたは相対パス（STリポジトリディレクトリからの）を指定できます。

YAML example

# -- DATA CONFIGURATION --
# Root directory for user data storage
dataRoot: C:\Users\Harry\Documents\ST-Data

Console example

node server.js --dataRoot="/Users/harry/ST-Data"
# OR
npm run start -- --dataRoot="/Users/harry/ST-Data"

デフォルトのdata rootパスは./dataで、これはSillyTavernのリポジトリ内のdataディレクトリを意味します。

1. デフォルトの場所からdataRootを移動したい場合のみ。それ以外の場合は、この部分をスキップしてください。 更新をpullした後、サーバーを最初に実行する_前に_、data rootを設定します。npm installを実行してconfig.yamlに新しい値を入力するか、コンソール引数を渡します。
2. すべてのデータはdefault-userアカウントに移行されます。以下のUsersを参照してください。

何もする必要はありません！自動移行は、STサーバーを起動して古いストレージ形式を検出したときに（/public/charactersディレクトリの存在を確認することで）、すべてを処理します。

ファイルを移動する際、自動バックアップが/backups/_migration/YYYY-MM-DD（現在の日付に解決される）ディレクトリに作成されますが、移行を実行する前に完全な手動バックアップを作成することは常に良い習慣です。

Dockerボリュームでのデータの移行は少し難しいですが、非常に簡単です。リポジトリで提供されているdocker-compose.ymlは変更を反映するように更新されましたが、カスタムワークフロー/デプロイメントを調整する必要がある場合があります。

Step 1. 新しいボリュームを作成し、コンテナ内の"/home/node/app/data"パスにマウントします。configボリュームは削除しないでください。

volumes:
    - "./config:/home/node/app/config"
    - "./data:/home/node/app/data"

Step 2. configボリュームからconfig.yamlファイル以外のすべてを、dataボリュームのdefault-userサブディレクトリに移動します。

Step 3. コンテナを再ビルドして起動します。

次のファイルとディレクトリがデータ移行の対象です。デフォルトの設定を想定すると、beforeとafterのパスは以下の表に記載されています。

1.12.0は、同じサーバー上にマルチユーザーセットアップを作成する（完全にオプションの）機能を追加し、複数のユーザーが同時であっても、独自の完全に分離されたSillyTavernインスタンスを使用できるようにします。ユーザーアカウントは、追加のプライバシー層のためにパスワード保護することもできます。

詳細については、Usersドキュメントを参照してください。