Installer Docker sur Ubuntu ou Debian, pas à pas

La procédure suit la documentation officielle de Docker pour Ubuntu et pour Debian, relue le 14 octobre 2026. Elle vaut pour Ubuntu 22.04, 24.04 et 26.04 LTS, et pour Debian 12 et 13, en 64 bits.

Avant de commencer

Il vous faut un accès SSH au serveur avec un compte qui peut utiliser sudo. Si vous ne savez pas encore vous connecter, lisez d'abord Se connecter en SSH à un serveur.

Retirez les paquets qui entreraient en conflit avec ceux de Docker, s'ils sont présents. La commande ne fait rien s'ils sont absents :

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

Vos images, conteneurs et volumes existants, rangés dans /var/lib/docker, ne sont pas supprimés par cette commande.

Installer Docker sur Ubuntu

L'installation se fait en quatre étapes :

1. ajouter la clé de signature du dépôt de Docker ;
2. déclarer ce dépôt auprès d'apt ;
3. installer les paquets ;
4. vérifier avec un conteneur de test.

Étape 1 : la clé de signature

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

Étape 2 : le dépôt

La commande lit le nom de code de votre version d'Ubuntu et écrit le fichier /etc/apt/sources.list.d/docker.sources :

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

Étape 3 : les paquets

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

Étape 4 : la vérification

Cette commande télécharge une petite image de test et affiche un message de bienvenue si tout fonctionne :

sudo docker run hello-world

Installer Docker sur Debian

La procédure est la même, avec deux différences : l'adresse du dépôt se termine par linux/debian, et le nom de code se lit dans VERSION_CODENAME.

La clé de signature, pour Debian

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

Le dépôt, pour Debian

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

Installez ensuite les paquets avec la même commande que pour Ubuntu, puis vérifiez avec sudo docker run hello-world.

Utiliser Docker sans sudo

Par défaut, seul root peut parler au démon Docker. Pour lancer docker sans sudo, ajoutez votre compte au groupe docker, comme le décrit la page des étapes après installation :

sudo groupadd docker
sudo usermod -aG docker $USER

Déconnectez-vous puis reconnectez-vous pour que le groupe soit pris en compte, et vérifiez avec docker run hello-world, cette fois sans sudo. Le groupe docker donne des droits équivalents à ceux de root : ne l'accordez qu'aux comptes qui administrent déjà le serveur.

Sur Ubuntu et Debian, Docker démarre seul au démarrage du serveur. Vérifiez qu'il tourne avec sudo systemctl status docker.

Ce que l'installation vous apporte

Les paquets installés donnent le moteur Docker, la commande docker, l'outil de construction buildx et la commande docker compose, qui lance plusieurs conteneurs décrits dans un fichier. Pour la suite, voir Docker Compose : lancer plusieurs conteneurs.

Sur un VPS Hubspace

Docker est déjà installé à la livraison, depuis le dépôt officiel de Docker, avec la commande docker compose. Le compte admin fait partie du groupe docker : vous pouvez sauter toutes les étapes de cet article et lancer directement vos conteneurs. Les journaux des conteneurs sont bornés pour ne pas remplir le disque. Seuls les ports 22, 80 et 443 sont ouverts sur Internet, y compris pour les ports que Docker publie : voir Ouvrir un port sur un serveur.

Questions fréquentes