Installer Docker sur Linux

Ce guide vous explique comment installer Docker Engine et Docker Compose Plugin sur un serveur Linux.

Vous apprendrez à :

• Installer Docker depuis les dépôts officiels
• Activer le service au démarrage
• Tester Docker avec un premier conteneur
• Configurer l’utilisation sans sudo
• Dépanner les erreurs courantes

0. Prérequis

Avant de commencer, assurez-vous d’avoir :

• Un serveur Linux (Debian 12 ou +, Ubuntu 22.04 ou +, RHEL 9, AlmaLinux, Rocky Linux)
• Un accès SSH avec droits sudo ou root
• Une connexion internet active

1. Supprimer les anciennes versions (si présentes)

sudo apt remove -y docker docker-engine docker.io containerd runc || true

sudo dnf remove -y docker docker-client docker-client-latest docker-common docker-latest docker-engine || true

Note : cette étape évite les conflits avec d’anciennes installations.

2. Installer les dépendances

Debian / Ubuntu

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release
sudo install -m 0755 -d /etc/apt/keyrings

RHEL / AlmaLinux / Rocky Linux

sudo dnf install -y curl ca-certificates gnupg dnf-plugins-core

3. Ajouter le dépôt officiel Docker

Debian / Ubuntu

curl -fsSL https://download.docker.com/linux/$(. /etc/os-release && echo $ID)/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

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

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

RHEL / AlmaLinux / Rocky Linux

sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. Démarrer Docker

sudo systemctl enable --now docker
sudo systemctl status docker --no-pager

Note : Docker doit être actif pour pouvoir lancer des conteneurs.

5. Vérifier l’installation

docker --version
docker compose version

Test rapide :

sudo docker run --rm hello-world

Si tout fonctionne, Docker est correctement installé.

6. Utiliser Docker sans sudo

Ajoutez votre utilisateur au groupe Docker :

sudo usermod -aG docker $USER

Rechargez la session :

newgrp docker

Test :

docker run --rm hello-world

7. Exemple avec Docker Compose

Créez un projet de test avec Nginx :

mkdir -p ~/docker-nginx && cd ~/docker-nginx

cat > docker-compose.yml <<'EOF'
services:
  web:
    image: nginx:stable
    ports:
      - "8080:80"
    restart: unless-stopped
EOF

Lancez le conteneur :

docker compose up -d
docker compose ps

Accédez ensuite à : http://IP_DU_SERVEUR:8080

Arrêter le service :

docker compose down

8. Mise à jour de Docker

Debian / Ubuntu

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

RHEL / AlmaLinux / Rocky Linux

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

9. Désinstallation complète

Debian / Ubuntu

sudo apt purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker /var/lib/containerd

RHEL / AlmaLinux / Rocky Linux

sudo dnf remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker /var/lib/containerd

10. Dépannage rapide

Logs Docker :

sudo journalctl -u docker -n 200 --no-pager

Redémarrer Docker :

sudo systemctl restart docker

Erreur de permissions :

sudo usermod -aG docker $USER
newgrp docker

Vérifier ports utilisés :

sudo ss -ltnp | grep :80
sudo ss -ltnp | grep :443

Conflit avec Podman :

sudo systemctl stop podman
sudo systemctl disable podman
sudo systemctl restart docker

Conclusion

Docker est maintenant installé et prêt à l’emploi sur votre serveur Linux.

Vous pouvez désormais lancer des conteneurs, utiliser Docker Compose et déployer facilement vos services.