La procédure suit la documentation officielle de Docker pour Debian et pour Ubuntu, relue le 16 octobre 2026. Elle vaut pour Debian 12 et 13, et pour Ubuntu 22.04, 24.04 et 26.04 LTS, en 64 bits.
Docker Engine ou Docker Desktop ?
Cet article installe Docker Engine, le moteur seul, piloté en ligne de commande. C'est ce qu'il faut sur un serveur Linux, un VPS par exemple.
Pour travailler sur votre ordinateur Windows ou macOS, installez plutôt Docker Desktop, une application qui embarque le moteur, la commande docker et Compose. Suivez la documentation officielle pour Windows, qui s'appuie sur WSL 2, ou pour macOS. Ces deux pages, relues le 16 octobre 2026, précisent que l'usage commercial de Docker Desktop dans une entreprise qui dépasse 250 salariés ou 10 millions de dollars de chiffre d'affaires annuel demande un abonnement payant.
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 Debian
L'installation se fait en quatre étapes :
- ajouter la clé de signature du dépôt de Docker ;
- déclarer ce dépôt auprès d'apt ;
- installer les paquets ;
- 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/debian/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 de Debian 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/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
É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
Affichez ensuite les versions installées du moteur et de Compose. La première commande est décrite dans la référence de docker version, la seconde sur la page d'installation de Compose :
sudo docker version
docker compose version
Installer Docker sur Ubuntu
La procédure est la même, avec deux différences : l'adresse du dépôt se termine par linux/ubuntu, et le nom de code se lit dans UBUNTU_CODENAME.
La clé de signature, pour Ubuntu
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
Le dépôt, pour Ubuntu
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
Installez ensuite les paquets avec la même commande que pour Debian, puis vérifiez avec sudo docker run hello-world et les deux commandes de version.
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. Portainer affiche ensuite vos conteneurs dans une interface web, et des applications comme Gitea, Metabase, Paperless-ngx ou un serveur Minecraft s'installent chacune par un fichier compose.
Dépannage
Un message permission denied qui cite /var/run/docker.sock signale que votre compte n'a pas accès au socket du démon. Selon la page des étapes après installation, ce socket appartient à root et n'est ouvert qu'aux membres du groupe docker. Ajoutez votre compte au groupe comme plus haut, puis reconnectez-vous ou lancez newgrp docker.
Le message Cannot connect to the Docker daemon indique le plus souvent que le démon ne tourne pas, d'après la page de dépannage du démon. Vérifiez son état, puis démarrez-le :
sudo systemctl status docker
sudo systemctl start docker
Si apt refuse d'installer docker-ce pour cause de conflit, un paquet non officiel de la distribution est encore là, comme docker.io ou containerd. La documentation demande de les retirer avant d'installer : relancez la commande de la section « Avant de commencer ».
Désinstaller Docker
La documentation pour Debian retire les paquets ainsi :
sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
Vos images, conteneurs et volumes restent sur le disque. Les deux commandes suivantes les effacent pour de bon, sans retour possible : sauvegardez d'abord les volumes qui portent des données.
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
Retirez enfin la déclaration du dépôt et sa clé :
sudo rm /etc/apt/sources.list.d/docker.sources
sudo rm /etc/apt/keyrings/docker.asc
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
Faut-il installer docker.io ou docker-ce ?
Le paquet docker.io vient de la distribution, docker-ce vient de Docker. Le second suit les versions publiées par Docker et apporte la commande docker compose par le paquet docker-compose-plugin. C'est celui que décrit la documentation officielle, et celui que supposent des outils comme Coolify ou Dokploy.
Le script get.docker.com convient-il pour un serveur ?
La documentation de Docker le réserve aux environnements de test et de développement. Sur un serveur en production, préférez le dépôt apt décrit ici : vous savez ce qui est installé, et les mises à jour passent par apt comme le reste du système.
Comment mettre Docker à jour ?
Comme n'importe quel paquet : sudo apt update puis sudo apt upgrade. Les conteneurs en cours sont arrêtés pendant le redémarrage du démon, puis relancés s'ils ont une politique de redémarrage, comme restart: unless-stopped dans un fichier compose.
Articles liés
- Docker compose up : lancer ses conteneursDocker Compose expliqué : écrire un fichier compose.yaml, lancer vos services avec docker compose up, lire les journaux et mettre à jour une application.
- Commandes Docker : les essentielles à connaîtreLes commandes Docker essentielles : lister les conteneurs, lire leurs journaux, entrer dans un conteneur, gérer les images et libérer de la place sans risque.
- Mettre à jour un conteneur DockerMettre à jour un conteneur Docker sans perdre ses données : sauvegarder le volume, télécharger l'image, recréer le conteneur et revenir en arrière si besoin.