Installer Docker sur Linux, Windows et macOS

Ce que vous allez apprendre

• Installation Linux : Docker Engine sur Ubuntu, Debian, Rocky Linux
• Installation Windows : Docker Desktop et alternative WSL2
• Installation macOS : Docker Desktop et alternative Colima
• Post-installation : permissions, groupe docker, démarrage automatique
• Vérification : commandes de test et diagnostic

Introduction

Docker s’installe différemment selon votre système d’exploitation. Sur Linux, vous installez Docker Engine nativement. Sur Windows et macOS, vous avez le choix entre Docker Desktop (application graphique avec licence commerciale) et des alternatives open-source comme WSL2 ou Colima.

Ce guide couvre les méthodes officielles et les alternatives pour chaque plateforme.

Prérequis

Système	Configuration minimale
Ubuntu	20.04+, 64-bit, kernel 5.10+
Debian	11+, 64-bit
Rocky/RHEL	8+, 64-bit
Windows	10 (21H2+) ou 11, WSL2 activé
macOS	12 (Monterey)+, Apple Silicon ou Intel

Glissez pour voir

Droits administrateur

L’installation de Docker nécessite des droits root (Linux) ou administrateur (Windows/macOS).

Docker Engine vs Docker Desktop

Avant d’installer, comprenez la différence entre les deux produits Docker.

Caractéristique	Docker Engine	Docker Desktop
Plateforme	Linux natif	Windows, macOS, Linux
Interface	CLI uniquement	GUI + CLI
Licence	Open source (Apache 2.0)	Gratuit personnel, payant entreprise (>250 employés)
Kubernetes	Non inclus	Inclus
Compose	Installation séparée	Inclus
VM	Non (natif)	Oui (WSL2/HyperKit)

Glissez pour voir

Recommandations :

• Serveur Linux → Docker Engine
• Développement Windows/macOS → Docker Desktop ou alternative
• Entreprise > 250 employés → Évaluer les alternatives (Podman, Colima)

Installation sur Linux

Ubuntu / Debian

1. Désinstaller les anciennes versions

   Supprimez les paquets obsolètes qui peuvent entrer en conflit :

   sudo apt remove docker.io docker-compose docker-doc podman-docker containerd runc

   Première installation

   Si vous n’avez jamais installé Docker, cette commande affichera simplement “package not found”. C’est normal.

2. Installer les dépendances

   sudo apt update
   sudo apt install -y ca-certificates curl gnupg

3. Ajouter la clé GPG Docker

   sudo install -m 0755 -d /etc/apt/keyrings
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
     sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
   sudo chmod a+r /etc/apt/keyrings/docker.gpg

   Pour Debian, remplacez ubuntu par debian dans l’URL.

4. Ajouter le repository Docker

   echo \
     "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
     https://download.docker.com/linux/ubuntu \
     $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
     sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. Installer Docker Engine

   sudo apt update
   sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

6. Vérifier l’installation

   sudo docker run hello-world

Rocky Linux / RHEL

1. Désinstaller les anciennes versions

   sudo dnf remove docker docker-client docker-client-latest \
     docker-common docker-latest docker-latest-logrotate \
     docker-logrotate docker-engine podman runc

2. Ajouter le repository Docker

   sudo dnf -y install dnf-plugins-core
   sudo dnf config-manager --add-repo \
     https://download.docker.com/linux/rhel/docker-ce.repo

   Pour Rocky Linux, utilisez également le repo RHEL (compatible).

3. Installer Docker Engine

   sudo dnf install -y docker-ce docker-ce-cli containerd.io \
     docker-buildx-plugin docker-compose-plugin

4. Démarrer et activer Docker

   sudo systemctl start docker
   sudo systemctl enable docker

5. Vérifier l’installation

   sudo docker run hello-world

Post-installation Linux

Après l’installation, configurez Docker pour une utilisation optimale.

Ajouter l’utilisateur au groupe docker

Par défaut, seul root peut utiliser Docker. Ajoutez votre utilisateur au groupe docker :

# Ajouter l'utilisateur courant au groupe docker
sudo usermod -aG docker $USER

# Appliquer les changements (sans déconnexion)
newgrp docker

# Ou déconnectez-vous et reconnectez-vous

Sécurité

Appartenir au groupe docker équivaut à avoir les privilèges root. Toute personne dans ce groupe peut monter n’importe quel répertoire dans un conteneur et accéder au système. Pour un environnement plus sécurisé, utilisez le mode rootless.

Configurer le démarrage automatique

# Activer le démarrage au boot
sudo systemctl enable docker.service
sudo systemctl enable containerd.service

# Vérifier le statut
sudo systemctl status docker

Configurer le daemon

Créez le fichier de configuration pour personnaliser Docker :

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json << 'EOF'
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}
EOF
sudo systemctl restart docker

Consultez le guide Configuration du daemon pour plus d’options.

Installation sur Windows

Docker Desktop

Docker Desktop est la solution officielle pour Windows avec interface graphique.

1. Activer WSL2

   Ouvrez PowerShell en administrateur :

   wsl --install

   Redémarrez l’ordinateur si demandé.

2. Télécharger Docker Desktop

   Téléchargez l’installateur depuis docker.com/products/docker-desktop.

3. Installer Docker Desktop

   • Exécutez l’installateur
   • Cochez “Use WSL 2 instead of Hyper-V” (recommandé)
   • Suivez l’assistant

4. Configurer Docker Desktop

   Au premier lancement :

   • Acceptez les conditions d’utilisation
   • Connectez-vous (optionnel pour usage personnel)
   • Dans Settings > Resources > WSL Integration, activez l’intégration avec vos distributions

5. Vérifier l’installation

   Ouvrez un terminal (PowerShell ou WSL) :

   docker run hello-world

Licence Docker Desktop

Docker Desktop est gratuit pour un usage personnel et les petites entreprises (< 250 employés, < $10M de revenus). Les entreprises plus grandes doivent souscrire à un abonnement payant.

Alternative : Docker dans WSL2

Pour éviter Docker Desktop (et sa licence), installez Docker Engine directement dans une distribution WSL2.

1. Installer une distribution WSL2

   wsl --install -d Ubuntu

2. Installer Docker Engine dans WSL2

   Ouvrez Ubuntu (WSL) et suivez les étapes Ubuntu/Debian ci-dessus.

3. Configurer le démarrage automatique

   Docker ne démarre pas automatiquement dans WSL2. Ajoutez à votre ~/.bashrc :

   # Démarrer Docker si pas déjà lancé
   if ! pgrep -x "dockerd" > /dev/null; then
       sudo dockerd > /dev/null 2>&1 &
   fi

   Pour éviter le mot de passe sudo, ajoutez dans /etc/sudoers.d/docker :

   %docker ALL=(ALL) NOPASSWD: /usr/bin/dockerd

4. Vérifier l’installation

   docker run hello-world

Avantages :

• Gratuit même pour les entreprises
• Docker Engine natif Linux
• Pas de VM supplémentaire

Inconvénients :

• Pas d’interface graphique
• Configuration manuelle du démarrage
• Pas de Kubernetes intégré

Installation sur macOS

Docker Desktop

1. Télécharger Docker Desktop

   • Apple Silicon (M1/M2/M3)
   • Intel

2. Installer l’application

   • Ouvrez le fichier .dmg
   • Glissez Docker dans Applications
   • Lancez Docker depuis Applications

3. Configurer les ressources

   Dans Settings > Resources, ajustez selon vos besoins :

   • CPUs : 2-4 recommandé
   • Memory : 4-8 GB recommandé
   • Disk : selon vos images

4. Vérifier l’installation

   docker run hello-world

Alternative : Colima

Colima (Containers on Lima) est une alternative open-source et gratuite à Docker Desktop sur macOS.

1. Installer Homebrew (si pas déjà installé)

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Installer Colima et Docker CLI

   brew install colima docker docker-compose

3. Démarrer Colima

   # Démarrage avec configuration par défaut
   colima start
   
   # Ou avec ressources personnalisées
   colima start --cpu 4 --memory 8 --disk 60

4. Vérifier l’installation

   docker run hello-world

5. Configurer le démarrage automatique (optionnel)

   brew services start colima

Commandes Colima utiles :

Commande	Description
colima start	Démarrer la VM
colima stop	Arrêter la VM
colima status	État actuel
colima delete	Supprimer la VM
colima ssh	Accéder à la VM

Glissez pour voir

Colima vs Docker Desktop

Colima offre les mêmes fonctionnalités Docker de base, gratuitement. Cependant, il manque l’interface graphique et certaines fonctionnalités avancées (extensions, Dev Environments).

Vérification de l’installation

Après installation, vérifiez que Docker fonctionne correctement.

Commandes de test

# Version client et serveur
docker version

# Informations système détaillées
docker info

# Test fonctionnel complet
docker run hello-world

docker version affiche les versions du client et du daemon :

Client: Docker Engine - Community
 Version:           24.0.7
 API version:       1.43
 ...

Server: Docker Engine - Community
 Engine:
  Version:          24.0.7
  API version:      1.43 (minimum version 1.12)
  ...

Erreur 'Cannot connect to Docker daemon'

Si seule la version client s’affiche avec une erreur de connexion, le daemon n’est pas accessible. Vérifiez :

# Le service est-il démarré ?
sudo systemctl status docker

# Êtes-vous dans le groupe docker ?
groups $USER

# Le socket existe-t-il ?
ls -la /var/run/docker.sock

docker info affiche les détails de configuration :

docker info | grep -E "Storage Driver|Docker Root Dir|Containers|Images"

Test fonctionnel avec hello-world

docker run hello-world

Cette commande :

1. Télécharge l’image hello-world depuis Docker Hub
2. Crée et démarre un conteneur
3. Affiche un message de confirmation
4. Arrête le conteneur

Si vous voyez “Hello from Docker!”, l’installation est réussie.

Dépannage

Linux

Sur Linux, les problèmes les plus fréquents concernent les permissions et les conflits de packages.

Problème	Solution
permission denied sur docker.sock	Ajouter l’utilisateur au groupe docker + newgrp docker
Docker ne démarre pas	Vérifier journalctl -u docker.service
docker.io vs docker-ce conflit	Désinstaller docker.io avant d’installer docker-ce
Espace disque insuffisant	Vérifier /var/lib/docker, exécuter docker system prune

Glissez pour voir

Windows

Sur Windows, les problèmes concernent généralement WSL2, la virtualisation ou les ressources système.

Problème	Solution
WSL2 non disponible	Exécuter wsl --install en admin
Docker Desktop ne démarre pas	Vérifier que la virtualisation est activée dans le BIOS
Erreur Hyper-V	Utiliser le backend WSL2 au lieu de Hyper-V
Lenteur extrême	Vérifier les ressources allouées dans Settings

Glissez pour voir

macOS

Sur macOS, les problèmes sont souvent liés aux performances de la VM ou aux certificats SSL corporate.

Problème	Solution
Docker Desktop lent	Augmenter CPU/RAM dans Settings > Resources
Colima ne démarre pas	colima delete puis colima start
Bind mount lent	Utiliser des volumes nommés pour les dépendances
Certificat SSL	Ajouter le certificat dans Keychain Access

Glissez pour voir

Commandes de diagnostic

# Logs du daemon Docker (Linux)
sudo journalctl -u docker.service --no-pager -n 50

# Informations système complètes
docker info

# Vérifier la connectivité
docker run --rm alpine ping -c 3 8.8.8.8

# Espace utilisé
docker system df

# Nettoyer les ressources inutilisées
docker system prune -a

À retenir

1. Docker Engine est open-source et s’installe nativement sur Linux
2. Docker Desktop est gratuit pour usage personnel mais payant pour les grandes entreprises
3. WSL2 permet d’installer Docker Engine sur Windows sans Docker Desktop
4. Colima est l’alternative gratuite à Docker Desktop sur macOS
5. Groupe docker = privilèges root — utilisez rootless mode pour plus de sécurité
6. docker version vérifie client et daemon, docker info affiche la configuration
7. Post-installation : groupe docker, démarrage automatique, daemon.json
8. newgrp docker applique les changements de groupe sans déconnexion

Prochaines étapes

Commandes Docker CLI Apprenez les commandes de base pour gérer conteneurs et images

Configurer le daemon Personnalisez daemon.json pour votre environnement

Sécuriser Docker Rootless mode et bonnes pratiques de sécurité

Concepts Docker Images, conteneurs, volumes — les fondamentaux

×

📖 Voir la documentation →