Skip to main content
必要に応じてロールバックできるよう、メジャーバージョンをアップグレードする前には必ず 整合性のあるバックアップ を取得することが重要です。
ayakaleaf toolkit↗ は git リポジトリなので、Toolkit の新機能を簡単に取得できます。bin/upgrade コマンドを実行し、画面の指示に従うだけです。 なお、Docker イメージのバージョン(config/version)は、Toolkit のコードの更新とは別に管理されています。Toolkit のコードを更新しても、実行中の Docker イメージのバージョンが自動的に変更されることはありません。つまり、ほとんどの場合、デプロイをアップグレードせずに Toolkit のバージョンだけをアップグレードできます。

bin/upgrade スクリプト

bin/upgrade コマンドを実行すると、スクリプトは Toolkit のコードに利用可能な更新があるかどうかを確認し、Toolkit の更新を提案します。このアップグレードはいつでも拒否でき、その場合は何も変更されません。 Toolkit のコードを更新することを選んだ場合、スクリプトは次に デフォルト の Docker イメージのバージョンが変更されているかどうかを確認し、ローカルのバージョンファイル(config/version)を新しいデフォルトに合わせてアップグレードするよう提案します。 バージョンを切り替えることを選んだ場合、スクリプトは Docker サービスの停止、バックアップの取得、Docker サービスの再起動という一連の手順を案内します。古いバージョンファイルは、その Docker イメージのバージョンにロールバックする必要が生じた場合に備えて、自動的に config/__old-version にコピーされます。
Docker イメージを手動でインポートするエアギャップ環境では、config/overleaf.rc ファイルで PULL_BEFORE_UPGRADE=false を設定してください。エアギャップ/オフライン環境でのデプロイの詳細については、こちら を確認してください。

アップグレードパス

v6.0.0 より前の Overleaf Community を実行している場合は、Overleaf の公式ドキュメント を参照してアップグレードを完了してください。
最終更新日 2026年10月4日