Installer Docker sur Ubuntu

Ce guide installe Docker Engine et Docker Compose sur Ubuntu 24.04 et 26.04 (64 bits), depuis le dépôt officiel de Docker. Il est préférable au paquet docker.io d’Ubuntu, plus ancien. Une fois Docker installé, voir les commandes générales Docker et les pages par thème (images, conteneurs, volumes, réseau, Docker Compose).

Prérequis

• Ubuntu 24.04 LTS (Noble) ou 26.04 LTS (Resolute), architecture 64 bits.
• Un utilisateur disposant de sudo.
• Un accès Internet.

1. Supprimer les anciens paquets

Si des paquets Docker non officiels sont installés, ils entrent en conflit avec l’installation officielle :

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

Si apt répond qu’aucun de ces paquets n’est installé, passez à l’étape suivante. Cette commande ne supprime pas vos images, conteneurs et volumes existants, conservés dans /var/lib/docker.

2. Ajouter le dépôt officiel Docker

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/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

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

sudo apt update

Le fichier docker.sources utilise le format DEB822. Le nom de la version d’Ubuntu (noble pour 24.04, resolute pour 26.04) est détecté automatiquement.

3. Installer Docker

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

Paquet	Rôle
docker-ce	Le service Docker (Docker Engine)
docker-ce-cli	La commande docker
containerd.io	Le moteur d’exécution des conteneurs
docker-buildx-plugin	Construction d’images avancée (docker buildx)
docker-compose-plugin	La commande docker compose

4. Vérifier l’installation

Le service démarre automatiquement après l’installation. Vérifiez-le et activez-le au démarrage de la machine :

sudo systemctl enable --now docker
sudo systemctl status docker

Lancez ensuite un conteneur de test :

sudo docker run --rm hello-world
sudo docker --version
sudo docker compose version

Le message « Hello from Docker! » confirme que tout fonctionne.

5. Utiliser Docker sans sudo

Par défaut, seul root peut parler au service Docker. Pour autoriser votre utilisateur :

sudo usermod -aG docker $USER

Fermez puis rouvrez votre session (ou lancez newgrp docker), et testez :

docker run --rm hello-world

Attention

Le groupe docker donne un accès équivalent à root sur la machine : un utilisateur qui peut lancer des conteneurs peut monter n’importe quel dossier de l’hôte. Ne l’accordez qu’à des utilisateurs de confiance.

Ubuntu 24.04 et 26.04 : différences à connaître

Les commandes de ce guide sont identiques sur les deux versions. Les changements ci-dessous concernent le système ou Docker ; ceux marqués « cassant » peuvent demander une action.

Changement cassant — Ubuntu 26.04 : cgroup v1 supprimé

Ubuntu 26.04 n’exécute plus que cgroup v2. Les conteneurs dont le système interne ne gère que cgroup v1 (images très anciennes, par exemple basées sur CentOS 7 ou Ubuntu 16.04) ne démarrent plus. Vérifier avant de migrer :

docker info | grep -i "cgroup version"   # doit afficher 2
stat -fc %T /sys/fs/cgroup/              # cgroup2fs = v2, tmpfs = v1

Sur 24.04, cgroup v2 est déjà utilisé par défaut : une image qui y fonctionne fonctionnera sur 26.04.

Changement cassant — Ubuntu 26.04 : sudo remplacé par sudo-rs

La commande sudo est désormais fournie par sudo-rs (réécriture en Rust ; l’ancienne version devient sudo.ws). Les commandes de ce guide fonctionnent à l’identique. Des scripts qui analysent la sortie de sudo, ou une configuration sudoers avancée, sont à revérifier.

Ubuntu 26.04 : apt 3 et suppression de apt-key

apt-key est supprimé. Ce guide n’en dépend pas : la clé est stockée dans /etc/apt/keyrings et référencée par Signed-By.

Docker Engine 29 : stockage des images (toutes versions d’Ubuntu)

À partir de Docker Engine 29, une nouvelle installation utilise le « containerd image store » par défaut. Les installations mises à jour conservent le pilote overlay2 et leurs images. Pour vérifier le stockage utilisé : docker info -f '{{ .DriverStatus }}'.

Un changement de stockage masque les images existantes (elles restent sur le disque) : les exporter avec docker save ou les renvoyer vers un registre avant de basculer. Pour revenir à overlay2, retirer l’option correspondante de /etc/docker/daemon.json et redémarrer le service.

Pare-feu (UFW)

Les ports publiés avec -p contournent les règles d’UFW : Docker écrit directement ses règles iptables. Un service lancé avec -p 8080:80 est donc joignable depuis l’extérieur même si UFW bloque le port 8080.

Pour n’exposer un service qu’à la machine locale, publiez sur 127.0.0.1 :

docker run -d -p 127.0.0.1:8080:80 nginx:alpine

Mise à jour

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

sudo apt update
sudo apt upgrade

Pour mettre à jour uniquement Docker :

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

Désinstallation

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

Danger

Les deux commandes suivantes suppriment définitivement toutes les images, conteneurs et volumes. N’exécutez-les que si vous voulez repartir de zéro.

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

Dépannage

Symptôme	Cause probable et solution
permission denied ... /var/run/docker.sock	L’utilisateur n’est pas dans le groupe docker, ou la session n’a pas été rouverte (section 5)
Cannot connect to the Docker daemon	Le service est arrêté : sudo systemctl start docker
E: Unable to locate package docker-ce	Le dépôt n’est pas ajouté ou apt update n’a pas été lancé après l’étape 2
Conflit avec containerd ou runc	Supprimer les anciens paquets (étape 1)
Lire les logs du service	journalctl -u docker --no-pager -n 100

Pour aller plus loin

• Documentation officielle : docs.docker.com/engine/install/ubuntu
• Suite : les commandes générales Docker et les pages par thème (images, conteneurs, volumes, réseau, Docker Compose)