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.
| Plateforme | Méthode de mise à niveau |
|---|---|
| macOS / Windows | Té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 |
| Docker | Aprè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
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
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
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
ollama create example-coder -f example-coder.modelfile
Méthode 2 : Pousser vers la bibliothèque de modèles pour une sauvegarde cloud
Exemple
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