Mise à niveau et migration de version d'Ollama

Comment mettre à niveau Ollama en toute sécurité, déplacer la bibliothèque de modèles vers un nouveau disque ou une nouvelle machine, et sauvegarder et restaurer des modèles personnalisés.

Faites bien ces trois choses, et vos ressources de modèles locaux vous appartiendront réellement, à l'abri de tout changement de matériel ou de version.


Mise à niveau sécurisée : stratégie avant action

La mise à niveau elle-même est simple ; le plus difficile est de « ne pas tout gâcher ». Stratégie de mise à niveau en trois étapes recommandée :

Étape 1, consultez les notes de version : les notes de version mettent en évidence les nouvelles fonctionnalités, les correctifs et les problèmes connus, en particulier la prise en charge des modèles et les changements d'interface.

Étape 2, sauvegardez les ressources critiques : exportez les recettes de modèles personnalisés utilisées (voir la méthode ci-dessous), et confirmez l’emplacement du répertoire des modèles.

Étape 3, testez avant le déploiement : pour les serveurs de production, vérifiez d’abord la mise à niveau sur une machine de test, puis déployez à plus grande échelle.

PlateformeMéthode de mise à niveau
macOS / WindowsTéléchargez automatiquement les mises à jour, cliquez sur « Redémarrer pour mettre à jour » dans la barre de menus ou la zone de notification
Linux (installation par script)Réexécutez le script d’installation officiel
Linux (installation manuelle)Supprimez d’abord l’ancien répertoire de bibliothèque, puis extrayez le nouveau paquet
DockerAprès avoir récupéré la nouvelle image, reconstruisez le conteneur ; le volume de données conserve tous les modèles

Si vous rencontrez des problèmes de compatibilité et devez revenir en arrière, ou si vous souhaitez essayer la version préliminaire, utilisez la variable de numéro de version pour un contrôle précis, installez la version spécifiée (voir les numéros de version dans GitHub Releases) :

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

Les versions préliminaires s’installent également via des numéros de version.

Avant une mise à niveau manuelle sous Linux, supprimez d’abord l’ancien répertoire de bibliothèque (sudo rm -rf /usr/lib/ollama) ; le mélange d’anciennes et de nouvelles bibliothèques d’inférence est la première cause de « comportement étrange après la mise à niveau ».


Migration de la bibliothèque de modèles : changement de disques et de machines

Les modèles font souvent plusieurs dizaines de GB ; l’essentiel de la migration tient en une phrase : déplacez le répertoire des modèles ailleurs, puis indiquez à Ollama où se trouve le nouvel emplacement.

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

Scénario 1 : remplacement de disque sur la même machine

Exemple

# 1. Après avoir arrêté le service, déplacez l'intégralité du répertoire de modèles vers le nouveau disque
sudo mv /usr/share/ollama/.ollama/models /data/ollama-models

# 2. Faites pointer la variable d'environnement vers le nouvel emplacement (voir le chapitre de configuration pour les trois méthodes de configuration selon la plateforme)
OLLAMA_MODELS=/data/ollama-models ollama serve

# 3. Une installation Linux standard nécessite de transférer la propriété à l'utilisateur ollama
sudo chown -R ollama:ollama /data/ollama-models

Scénario 2 : Migration vers une nouvelle machine

Exemple

# Ancienne machine : empaqueter l'intégralité du répertoire des modèles (y compris les blobs et les manifestes)
tar czf models-backup.tar.gz -C ~/.ollama models

# Nouvelle machine : installer la même version d'Ollama, puis extraire vers l'emplacement correspondant
mkdir -p ~/.ollama
tar xzf models-backup.tar.gz -C ~/.ollama

# Vérifier que la liste des modèles est complète
ollama list

Deux détails déterminent le succès ou l'échec d'une migration : la version d'Ollama sur la nouvelle machine doit être aussi cohérente que possible avec celle de l'ancienne machine ; la structure blobs et manifests sous le répertoire models doit être préservée telle quelle, ne copiez pas uniquement des fichiers de modèle individuels.


Sauvegarde et restauration des modèles personnalisés

Les modèles personnalisés (produits construits à partir de Modelfile) ont deux méthodes de sauvegarde ; il est recommandé de faire les deux.

Méthode 1 : Exporter la recette vers Git

Exemple

# Exporter la recette complète du modèle
ollama show --modelfile example-coder > example-coder.modelfile

Remarque sur un détail : la ligne FROM dans la recette exportée pointe vers le chemin du fichier blob local, elle ne peut donc pas être utilisée directement après avoir changé de machine. Lors de la restauration, remettez FROM sur le nom du modèle de base (par exemple FROM qwen3.5:9b) et reconstruisez.

Exemple

# Après avoir modifié FROM, reconstruisez et la recette est restaurée
ollama create example-coder -f example-coder.modelfile

Méthode 2 : Pousser vers la bibliothèque de modèles pour une sauvegarde cloud

Exemple

# Copier vers un nom avec un espace de noms puis push (pour la publication privée, voir le chapitre sur le déploiement en équipe)
ollama cp example-coder myteam/example-coder:v1
ollama push myteam/example-coder:v1

Organisation recommandée : placer tous les Modelfiles dans un seul dépôt Git pour la gestion, en combinaison avec un script pour reconstruire l'environnement à partir de zéro — le matériel sera remplacé, les systèmes seront réinstallés, mais avec les recettes en main, tous les modèles personnalisés pourront être restaurés en dix minutes.

Autres extensions