Installation d'Ollama

Ollama prend en charge plusieurs systèmes d'exploitation, notamment macOS, Windows, Linux, et l'exécution via des conteneurs Docker.

Ollama a de faibles exigences système et peut exécuter des modèles avec un CPU pur, mais le fait que vous ayez ou non un GPU dédié détermine directement la vitesse de génération.

PlateformeConfiguration système requisePrise en charge GPU
macOSmacOS Sonoma (v14) ou version ultérieureLes puces Apple de la série M sont accélérées via Metal ; les puces Intel fonctionnent uniquement sur CPU.
WindowsWindows 10 22H2 ou version ultérieure (Home/Pro)Pilote NVIDIA 551.61+ ; AMD nécessite ROCm v7 ou un pilote Vulkan
LinuxDistributions courantes (Ubuntu, Debian, CentOS, etc.)NVIDIA / AMD ROCm v7 / Vulkan, prend également en charge le CPU pur
DockerUn environnement Docker fonctionnelLinux et Windows (WSL2) prennent en charge le GPU passthrough ; macOS ne le prend pas en charge.

Les fichiers de modèle vont de quelques GB à des centaines de GB. Veuillez réserver suffisamment d'espace disque avant l'installation. Par défaut, les modèles sont stockés dans le répertoire personnel de l'utilisateur. Lorsque l'espace est insuffisant, vous pouvez utiliser les variables d'environnementOLLAMA_MODELSpour les migrer vers un autre disque.

Commande d'installation en une ligne pour Linux/macOS :

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

Commande d'installation en une ligne pour Windows :

irm https://ollama.com/install.ps1 | iex

Vous pouvez également télécharger directement l'installateur. Adresse de téléchargement officielle :https://ollama.com/download。

Vous pouvez télécharger le paquet correspondant en fonction de votre système. Pour les environnements serveur, le script Linux ou Docker est recommandé.

Ollama 安装方式选择流程图

L'interface Ollama est la suivante :


1. Installation sur Windows

Ouvrez un navigateur et rendez-vous sur le site officiel d’Ollama :https://ollama.com/downloadet téléchargez l’installateur pour Windows.

L’adresse de téléchargement est :https://ollama.com/download/OllamaSetup.exe。

Une fois le téléchargement terminé, double-cliquez sur l’installateur et suivez les instructions pour terminer l’installation.

Après l’installation, la commande ollama peut être utilisée directement dans cmd, PowerShell ou Windows Terminal.

Vous pouvez également installer via la ligne de commande :

irm https://ollama.com/install.ps1 | iex

Vérifier l'installation

Ouvrez l’Invite de commandes ou PowerShell et saisissez la commande suivante pour vérifier si l’installation a réussi :

ollama --version

Si un numéro de version s’affiche, l’installation a réussi.

Modifier le chemin d’installation (facultatif)

Si vous devez installer Ollama dans un chemin non par défaut, vous pouvez spécifier le chemin via la ligne de commande lors de l’installation, par exemple :

OllamaSetup.exe /DIR="d:\some\location"

Cela installe Ollama dans le répertoire spécifié.


2. Installation sur macOS

Ouvrez un navigateur et rendez-vous sur le site officiel d'Ollama :https://ollama.com/downloadet téléchargez l'installateur pour macOS.

L'adresse de téléchargement est :https://ollama.com/download/Ollama.dmg。

Vous pouvez aussi installer avec une commande en une ligne :

curl -fsSL https://ollama.com/install.sh | sh
Une fois le téléchargement terminé, double-cliquez sur le paquet d'installation et suivez les instructions pour terminer l'installation.

Après l'installation, vérifiez avec la commande suivante :

ollama --version

Si un numéro de version s’affiche, l’installation a réussi.


3. Installation sous Linux

Sous Linux, vous pouvez utiliser le script d'installation en une ligne. Ouvrez un terminal et exécutez la commande suivante :

curl -fsSL https://ollama.com/install.sh | bash

Après l'installation, vérifiez avec la commande suivante :

ollama --version

Si un numéro de version s’affiche, l’installation a réussi.


Déploiement Docker

Docker convient aux serveurs et aux scénarios nécessitant une isolation de l'environnement. L'image officielle est prête à l'emploi, et un environnement CPU peut être démarré avec une seule commande.

# 启动 Ollama 容器:数据卷持久化模型,映射 11434 端口
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama

Transmission directe du GPU NVIDIA

Pour permettre au conteneur d'utiliser un GPU NVIDIA, vous devez d'abord installer NVIDIA Container Toolkit. En prenant Ubuntu/Debian comme exemple :

# 1. 配置软件仓库
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey \
    | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -fsSL https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list \
    | sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' \
    | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update

# 2. 安装工具包
sudo apt-get install -y nvidia-container-toolkit

# 3. 配置 Docker 运行时并重启
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Ajoutez ensuite le paramètre--gpus=allpour démarrer le conteneur :

# 带 GPU 的启动命令
docker run -d --gpus=all -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama

Transmission directe du GPU AMD

Pour les GPU AMD, utilisez une image avec le tag rocm et montez les périphériques :

# AMD ROCm 版本,挂载 GPU 设备
docker run -d --device /dev/kfd --device /dev/dri -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama:rocm

Exécuter des modèles dans un conteneur

Une fois le conteneur démarré, utilisez exec pour exécuter des commandes ollama à l'intérieur du conteneur :

# 在容器内拉取并运行 qwen3.5
docker exec -it ollama ollama run qwen3.5

Par exemple :

$ docker exec -it ollama ollama run qwen3.5
>>> 用一句话介绍 Example
Example是一个面向编程初学者的中文教程网站。
>>> /bye

Docker Desktop pour macOS ne prend pas en charge le passthrough GPU ; les conteneurs ne peuvent effectuer que l'inférence sur CPU. Les utilisateurs d'Apple Silicon qui souhaitent une accélération GPU doivent utiliser directement l'installateur natif.


Vérifier l'installation

Quelle que soit la méthode d'installation utilisée, vérifiez finalement avec trois étapes unifiées : vérifier la version, lancer une conversation et vous connecter à l'API.

Étape 1 : Confirmer la version

# 输出版本号说明命令行可用
ollama -v

Étape 2 : Ouvrir le menu interactif

Saisir ollama directement sans argument ouvre le menu interactif, où vous pouvez sélectionner un modèle pour démarrer une conversation :

$ ollama
Welcome to Ollama

  Run a model     Start an interactive chat
  Launch tools    Claude Code, VS Code, and more

Étape 3 : Vérifier le service API

Après l'installation, Ollama fournit une API sur le port local 11434. Utilisez curl pour interroger le point de terminaison de version afin de confirmer que le service écoute :

# 本地 API 默认地址,返回 JSON 版本信息
curl http://localhost:11434/api/version
{"version":"0.17.0"}

Sous macOS et Windows, Ollama s'exécute en arrière-plan (barre de menus / icône de la zone de notification) après l'installation, et l'API est automatiquement disponible. Sous Linux, lorsque vous utilisez le service systemd, elle est également disponible au démarrage ; seule la méthode manuelle ollama serve nécessite de garder le terminal ouvert.


Mise à niveau et désinstallation

La mise à niveau est simple, mais la désinstallation diffère selon la plateforme. Faites particulièrement attention à ne pas supprimer accidentellement les modèles téléchargés.

Mettre à niveau vers une nouvelle version

PlateformeMéthode de mise à niveau
macOS / WindowsTélécharge automatiquement les mises à jour. Cliquez sur « Redémarrer pour mettre à jour » dans la barre de menus ou l'icône de la zone de notification pour appliquer.
Linux (installation par script)Réexécutez le script d'installation
Linux (installation manuelle)Supprimez d'abord l'ancienne bibliothèque, puis retéléchargez et extrayez le nouveau paquet.
DockerRécupérez la dernière image et reconstruisez le conteneur ; les volumes de données conservent les modèles.

Désinstallation : macOS

Sur macOS, vous devez nettoyer manuellement l'application et les fichiers résiduels. Exécutez chaque ligne :

Exemple

# Supprimer l'application et la ligne de commande
sudo rm -rf /Applications/Ollama.app
sudo rm /usr/local/bin/ollama

# Supprimer les fichiers résiduels de l'application
rm -rf "~/Library/Application Support/Ollama"
rm -rf "~/Library/Caches/com.electron.ollama/"
rm -rf ~/Library/Caches/ollama

# Supprimer les modèles et la configuration (taille importante, à supprimer uniquement si vous êtes sûr de ne pas en avoir besoin)
rm -rf ~/.ollama

Désinstaller : Windows

Dans les Paramètres, trouvez Ollama sous « Applications - Applications installées » et cliquez sur Désinstaller.

Si vous avez migré les modèles vers un autre répertoire via OLLAMA_MODELS, le désinstalleur ne supprimera pas ces fichiers de modèles ; vous devez les nettoyer manuellement.

Désinstallation : Linux

Exemple

# Arrêter et supprimer le service système
sudo systemctl stop ollama
sudo systemctl disable ollama
sudo rm /etc/systemd/system/ollama.service

# Supprimer les fichiers du programme (le répertoire lib peut être /usr/local/lib, /usr/lib, ou /lib)
sudo rm -r $(which ollama | tr 'bin' 'lib')
sudo rm $(which ollama)

# Supprimer l'utilisateur de service et les données du modèle
sudo userdel ollama
sudo groupdel ollama
sudo rm -r /usr/share/ollama

Problèmes d'installation courants

La plupart des problèmes lors de l'installation sont liés au réseau, au disque et à l'environnement du terminal. Le tableau ci-dessous résume les plus fréquents.

SymptômeCauseSolution
Le terminal indique que la commande ollama n'existe pasL'interface CLI n'est pas dans le PATHSur macOS, redémarrez l'application Ollama une fois et acceptez de créer le lien /usr/local/bin ; sur Windows, ouvrez une nouvelle fenêtre de terminal.
Le téléchargement du modèle est lent ou échoueLe réseau vers le serveur d'origine est instableConfigurez le proxy HTTPS_PROXY ; les téléchargements interrompus reprennent automatiquement à partir des points de reprise, il suffit de relancer pull.
Le téléchargement est particulièrement lent dans WSL2Problème de fonctionnalité de l'adaptateur réseau WSL de Win10Désactiver Large Send Offload V2 (IPv4/IPv6) sur l'adaptateur vEthernet (WSL).
Le terminal Windows affiche des caractères carrés brouillésLa police de l'ancien terminal ne prend pas en charge les caractères de progressionChangez la police du terminal ou passez à Windows Terminal
Message d'espace disque insuffisantLe disque où se trouve le répertoire utilisateur a un espace limitéUtilisez OLLAMA_MODELS pour migrer les modèles vers un disque de grande capacité (détaillé dans la section des variables d'environnement)

Lors de la configuration du proxy, ne définissez queHTTPS_PROXYC'est tout. Ne définissez pas HTTP_PROXY : Ollama ne récupère les modèles que via HTTPS. Ajouter un proxy HTTP peut au contraire interrompre la connexion entre le client et le serveur.

Autres extensions