Ollama のバージョンアップと移行

Ollama を安全にアップグレードし、モデルライブラリを新しいディスクや新しいマシンに移行する方法、およびカスタムモデルのバックアップと復元。

この3つを実行すれば、ローカルモデルの資産は本当に自分のものになり、あらゆるハードウェアやバージョンの変化を恐れる必要はありません。


安全なアップグレード:戦略が操作に先立つ

アップグレード自体は簡単ですが、難しいのは「失敗しないこと」です。おすすめの3ステップアップグレード戦略:

ステップ1、更新内容を確認:Release Notes には新機能、修正、既知の問題が記載されています。特にモデルサポートとインターフェースの変更に注目してください。

ステップ2、重要な資産をバックアップ:使用中のカスタムモデルのレシピをエクスポートし(方法は後述)、モデルディレクトリの場所を確認します。

ステップ3、テストしてから展開:本番サーバーはまずテスト機でアップグレードを検証してから、全面的に展開します。

プラットフォームアップグレード方法
macOS / Windows自動でアップデートをダウンロードし、メニューバーまたはトレイの「Restart to update」をクリック
Linux(スクリプトインストール)公式インストールスクリプトを再実行
Linux(手動インストール)古いライブラリディレクトリを削除してから、新しいパッケージを解凍
Docker新しいイメージをpullした後、コンテナを再作成し、データボリュームにすべてのモデルを保持

互換性の問題でロールバックが必要な場合、またはプレリリース版を試したい場合は、バージョン番号変数で正確に制御し、指定したバージョンをインストールします(バージョン番号は GitHub Releases を参照):

curl -fsSL https://ollama.com/install.sh | OLLAMA_VERSION=0.5.7 sh

プレリリース版も同様にバージョン番号でインストールします。

Linux の手動アップグレード前に、古いライブラリディレクトリ(sudo rm -rf /usr/lib/ollama)を削除してください。新旧の推論ライブラリを混在させることが「アップグレード後の動作がおかしくなる」最大の原因です。


モデルライブラリの移行:ディスク交換とマシン交換

モデルは数十GBに達することもあり、移行の本質は一言だけです:models ディレクトリを移し、Ollama に新しい場所を伝えることです。

迁移三步:导出备份、迁移数据、验证

シーン1:同一マシンでのディスク交換

例

# 1. サービスを停止した後、モデルディレクトリ全体を新しいディスクに移動する
sudo mv /usr/share/ollama/.ollama/models /data/ollama-models

# 2. 環境変数で新しい場所を指定する(3プラットフォームの設定方法は設定章を参照)
OLLAMA_MODELS=/data/ollama-models ollama serve

# 3. Linux 標準インストールでは所有者を ollama ユーザーに変更する必要がある
sudo chown -R ollama:ollama /data/ollama-models

シーン2:新しいマシンへの移行

例

# 旧マシン:models ディレクトリ全体をパッケージ化する(blobs と manifests を含む)
tar czf models-backup.tar.gz -C ~/.ollama models

# 新マシン:同じバージョンの Ollama をインストールした後、対応する場所に解凍する
mkdir -p ~/.ollama
tar xzf models-backup.tar.gz -C ~/.ollama

# モデルリストが完全であることを検証する
ollama list

移行の成否を左右する2つの細かい点:新マシンの Ollama バージョンはできるだけ旧マシンと一致させること;models ディレクトリ内の blobs と manifests の構造は元のまま保持し、単一のモデルファイルだけをコピーしないこと。


カスタムモデルのバックアップと復元

カスタムモデル(Modelfile で構築した成果物)には2つのバックアップ方法があり、両方行うことをおすすめします。

方法1:レシピをGitにエクスポート

例

# モデルの完全なレシピをエクスポートする
ollama show --modelfile サンプル-coder > サンプル-coder.modelfile

1つの詳細に注意:エクスポートしたレシピの FROM 行はローカルマシンの blob ファイルパスを指しているため、マシンを変更すると直接使用できません。復元時は FROM をベースモデル名(例:FROM qwen3.5:9b)に変更してから再構築してください。

例

# FROM を変更して再構築すると、レシピが復元される
ollama create サンプル-coder -f サンプル-coder.modelfile

方法2:モデルライブラリにプッシュしてクラウドバックアップ

例

# 名前空間付きの名前にコピーしてからプッシュする(プライベート公開はチーム導入章を参照)
ollama cp サンプル-coder myteam/サンプル-coder:v1
ollama push myteam/サンプル-coder:v1

おすすめの整理方法:すべての Modelfile を1つの Git リポジトリで管理し、ゼロから環境を再構築するスクリプトを併用します——ハードウェアは交換され、システムは再インストールされますが、レシピがあれば10分ですべてのカスタムモデルを復元できます。

その他の拡張