Installer Docker sur Debian ou Ubuntu

1. Quel paquet installer ?

Plusieurs versions de Docker circulent sous Linux :

Cette fiche suit la méthode officielle, avec le dépôt de Docker. Docker prend en charge Debian 13 « Trixie » et Debian 12 « Bookworm », ainsi que les versions maintenues d'Ubuntu.

2. Retirer les anciens paquets

Si Docker a déjà été installé depuis les dépôts de la distribution, retirez les paquets en conflit. La commande ne touche qu'à ceux qui sont réellement installés :

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc podman-docker containerd runc | cut -f1)

Les images, conteneurs et volumes existants, rangés dans /var/lib/docker/, sont conservés.

3. Ajouter le dépôt officiel

Sur Debian

Installer les outils et la clé de signature du dépôt :

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Déclarer le dépôt, au format .sources (deb822) utilisé par Debian 13 :

sudo tee /etc/apt/sources.list.d/docker.sources <<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
sudo apt update

La commande remplit automatiquement le nom de la version (trixie ou bookworm) et l'architecture (amd64 ou arm64).

Sur Ubuntu

Les commandes sont les mêmes, en remplaçant debian par ubuntu dans les deux adresses, et la ligne Suites par :

Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")

Vérifiez le contenu du fichier créé :

cat /etc/apt/sources.list.d/docker.sources

Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: amd64
Signed-By: /etc/apt/keyrings/docker.asc

4. Installer Docker

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

5. Vérifier l'installation

Le service doit être actif et démarrer avec le système :

systemctl status docker
sudo systemctl enable docker.service containerd.service

Lancez le conteneur de test :

sudo docker run hello-world

Hello from Docker!
This message shows that your installation appears to be working correctly.

Vérifiez les versions :

docker --version
docker compose version

6. Utiliser Docker sans sudo : le groupe docker

Par défaut, seul root peut piloter Docker. Pour éviter de taper sudo à chaque commande, on peut ajouter son compte au groupe docker :

sudo usermod -aG docker spo

Déconnectez-vous puis reconnectez-vous (ou lancez newgrp docker) pour que le changement prenne effet, puis testez :

docker run hello-world

7. Limiter la taille des journaux

Par défaut, Docker conserve sans limite tout ce que les conteneurs écrivent sur leur sortie : un conteneur bavard peut remplir le disque en quelques semaines. Créez le fichier /etc/docker/daemon.json :

{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

Puis redémarrez Docker :

sudo systemctl restart docker

Le pilote local compresse les journaux et applique la rotation : au plus 3 fichiers de 10 Mo par conteneur. Le réglage s'applique aux conteneurs créés après le changement ; recréez les autres (docker compose up -d --force-recreate). Les journaux se lisent toujours avec docker logs nom-du-conteneur.

8. Le piège du pare-feu

Les parades, de la plus simple à la plus complète :

9. Vérification finale

10. Mettre à jour et désinstaller

Docker se met à jour avec le reste du système :

sudo apt update
sudo apt full-upgrade

Pour désinstaller complètement :

sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker /var/lib/containerd
sudo rm /etc/apt/sources.list.d/docker.sources /etc/apt/keyrings/docker.asc

À retenir

• Installez depuis le dépôt officiel de Docker (docker-ce), pas en mélangeant avec docker.io.
• Docker Compose est inclus : docker compose (avec une espace).
• Le groupe docker équivaut à root : à réserver aux administrateurs.
• Configurez la rotation des journaux dans /etc/docker/daemon.json dès l'installation.
• Les ports publiés contournent ufw : publiez sur 127.0.0.1 derrière un reverse proxy, ou filtrez en amont.