> ## Content Index
> Fetch the complete content index at: https://infrabook.fr/llms.txt
> Use this file to discover other available public pages before exploring further.

# Installer Docker sur Debian
- URL: https://infrabook.fr/installer-docker-sur-debian/
- Published: 2026-09-21T20:23:58.000Z
- Updated: 2026-09-21T20:23:58.000Z
- Author: YN
- Tags: Docker, Docker compose, Debian, Conteneur

# 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.

```bash
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 :

```bash
sudo apt update

```

Installer les outils nécessaires :

```bash
sudo apt install -y ca-certificates curl

```

---

## 3\. Ajouter le dépôt Docker

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

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

```

Télécharger la clé officielle Docker :

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

```

Autoriser APT à lire la clé :

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

```

Ajouter le dépôt Docker :

```bash
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 :

```bash
sudo apt update

```

---

## 4\. Installer Docker

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

```bash
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 :

```bash
sudo systemctl status docker

```

Pour quitter l’affichage de `systemctl`, appuyer sur :

```text
q

```

Si Docker n’est pas démarré :

```bash
sudo systemctl start docker

```

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

```bash
sudo systemctl enable docker

```

---

## 6\. Tester l’installation

Lancer le conteneur de test :

```bash
sudo docker run --rm hello-world

```

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

Vérifier également Docker Compose :

```bash
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` :

```bash
sudo usermod -aG docker $USER

```

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

Tester :

```bash
docker ps

```

---

## Commandes utiles

Afficher les conteneurs en cours d’exécution :

```bash
docker ps

```

Afficher tous les conteneurs :

```bash
docker ps -a

```

Afficher les images disponibles :

```bash
docker images

```

Afficher les volumes :

```bash
docker volume ls

```

Afficher les réseaux Docker :

```bash
docker network ls

```

Afficher les informations générales de Docker :

```bash
docker info

```

---

## Docker Compose

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

```bash
docker compose up -d

```

Afficher les conteneurs du projet :

```bash
docker compose ps

```

Afficher les logs :

```bash
docker compose logs -f

```

Arrêter le projet :

```bash
docker compose down

```

---

## Mettre Docker à jour

Mettre à jour les dépôts :

```bash
sudo apt update

```

Installer les dernières versions disponibles :

```bash
sudo apt upgrade

```

Vérifier ensuite la version de Docker :

```bash
docker --version

```

---

## Désinstaller Docker

Supprimer Docker et ses composants :

```bash
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.

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

```

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

```bash
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 :

```bash
docker --version
docker compose version
docker ps

```