Skip to main content

Installer Docker sur Debian

Docker permet d’exécuter des applications dans des conteneurs isolés et faciles à déployer. Cette procédure installe Docker Engine et Docker Compose depuis le dépôt officiel Docker.

Prérequis

Cette procédure est prévue pour :

  • Debian 12 (Bookworm)
  • Debian 13 (Trixie)
  • un compte disposant de sudo
  • une connexion Internet

Attention — Pare-feu

Docker gère lui-même une partie des règles réseau lorsqu’un port de conteneur est publié. Si le serveur utilise ufw ou firewalld, vérifiez les règles d’accès aux ports exposés après l’installation.

1. Supprimer les anciens paquets Docker

Si Docker n’a jamais été installé sur le serveur, cette commande peut simplement indiquer qu’aucun paquet n’est présent.

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

Information

Cette commande supprime les paquets en conflit. Elle ne supprime pas automatiquement les images, conteneurs et volumes déjà présents dans /var/lib/docker.

2. Installer les dépendances nécessaires

Mettre à jour la liste des paquets :

sudo apt update

Installer les outils nécessaires :

sudo apt install -y ca-certificates curl

3. Ajouter le dépôt Docker

Créer le dossier destiné aux clés APT :

sudo install -m 0755 -d /etc/apt/keyrings

Télécharger la clé officielle Docker :

sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
  -o /etc/apt/keyrings/docker.asc

Autoriser APT à lire la clé :

sudo chmod a+r /etc/apt/keyrings/docker.asc

Ajouter le dépôt Docker :

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Actualiser les dépôts :

sudo apt update

4. Installer Docker

Installer Docker Engine, Docker Compose et les composants nécessaires :

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

5. Vérifier le service Docker

Vérifier que Docker fonctionne :

sudo systemctl status docker

Pour quitter l’affichage de systemctl, appuyer sur :

q

Si Docker n’est pas démarré :

sudo systemctl start docker

Pour s’assurer qu’il démarre automatiquement avec le serveur :

sudo systemctl enable docker

6. Tester l’installation

Lancer le conteneur de test :

sudo docker run --rm hello-world

Si un message de confirmation apparaît, Docker fonctionne correctement.

Vérifier également Docker Compose :

sudo docker compose version

7. Utiliser Docker sans sudo — optionnel

Par défaut, l’utilisation de Docker peut nécessiter sudo.

Ajouter votre utilisateur au groupe docker :

sudo usermod -aG docker $USER

Fermez ensuite votre session SSH ou votre session utilisateur, puis reconnectez-vous.

Tester :

docker ps

Commandes utiles

Afficher les conteneurs en cours d’exécution :

docker ps

Afficher tous les conteneurs :

docker ps -a

Afficher les images disponibles :

docker images

Afficher les volumes :

docker volume ls

Afficher les réseaux Docker :

docker network ls

Afficher les informations générales de Docker :

docker info

Docker Compose

Pour démarrer les services définis dans un fichier compose.yaml ou docker-compose.yml :

docker compose up -d

Afficher les conteneurs du projet :

docker compose ps

Afficher les logs :

docker compose logs -f

Arrêter le projet :

docker compose down

Mettre Docker à jour

Mettre à jour les dépôts :

sudo apt update

Installer les dernières versions disponibles :

sudo apt upgrade

Vérifier ensuite la version de Docker :

docker --version

Désinstaller Docker

Supprimer Docker et ses composants :

sudo apt purge -y \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin \
  docker-ce-rootless-extras

Attention — Suppression des données

Les commandes suivantes suppriment définitivement les images, conteneurs, volumes et données locales Docker.

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

Supprimer le dépôt Docker et sa clé :

sudo rm -f /etc/apt/sources.list.d/docker.sources
sudo rm -f /etc/apt/keyrings/docker.asc

Installation terminée

Docker Engine et Docker Compose sont maintenant installés.

Pour vérifier rapidement l’environnement :

docker --version
docker compose version
docker ps
Back to top