Réponse rapide : Pour installer Docker sur Ubuntu, ajoutez le dépôt officiel Docker via apt, importez la clé GPG, puis exécutez sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin. Vérifiez l’installation avec sudo docker run hello-world. Compatible Ubuntu 22.04, 24.04 et 26.04 LTS.
Docker s’est imposé comme l’outil de référence pour la conteneurisation d’applications. Que vous soyez développeur, administrateur système ou architecte cloud, maîtriser Docker sur Ubuntu est aujourd’hui une compétence fondamentale. Légèreté, portabilité, reproductibilité les avantages sont indéniables.
Pourtant, une mauvaise installation peut vite devenir un casse-tête. Versions conflictuelles, paquets obsolètes issus des dépôts Ubuntu non officiels, permissions mal configurées… Les pièges sont nombreux. Ce guide vous accompagne pas à pas, depuis la préparation de votre environnement jusqu’aux étapes post-installation, en s’appuyant exclusivement sur la documentation officielle de Docker.
À la fin de ce guide, vous disposerez d’une installation propre, à jour, et prête pour la production.
Quels sont les prérequis pour installer Docker sur Ubuntu ?
Quelles versions d’Ubuntu sont compatibles avec Docker Engine ?
Docker Engine est officiellement compatible avec les versions 64 bits suivantes d’Ubuntu (selon la documentation officielle Docker, 2026) :
- Ubuntu Resolute 26.04 (LTS)
- Ubuntu Questing 25.10
- Ubuntu Noble 24.04 (LTS)
- Ubuntu Jammy 22.04 (LTS)
Docker Engine supporte les architectures x86_64 (amd64), armhf, arm64, s390x et ppc64le. Les distributions dérivées d’Ubuntu, comme Linux Mint, ne sont pas officiellement prises en charge.
Faut-il désinstaller les anciennes versions de Docker avant d’installer Docker Engine ?
Oui. Les dépôts Ubuntu peuvent fournir des paquets Docker non officiels qui entrent en conflit avec les paquets officiels. Avant toute installation, supprimez ces paquets :
$ sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
Les paquets concernés sont : docker.io, docker-compose, docker-compose-v2, docker-doc, podman-docker, containerd et runc.
Bon à savoir : Si aucun de ces paquets n’est installé,
aptvous le signalera simplement. Vos images, conteneurs et volumes stockés dans/var/lib/docker/ne sont pas supprimés automatiquement.
➡️ WAMP vs MAMP vs XAMPP : comparatif serveurs locaux
Comment installer Docker Engine sur Ubuntu avec le dépôt apt officiel ?
L’installation via le dépôt apt officiel de Docker est la méthode recommandée. Elle garantit l’accès aux dernières versions stables et simplifie les mises à jour futures.
Étape 1 : Configurer le dépôt apt de Docker
Avant d’installer Docker Engine pour la première fois, configurez le dépôt officiel. Exécutez les commandes suivantes dans votre terminal :
# Ajouter la clé GPG officielle de 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
# Ajouter le dépôt aux sources apt :
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
Ces commandes effectuent trois actions essentielles : elles installent les certificats nécessaires, importent la clé GPG pour vérifier l’authenticité des paquets Docker, puis enregistrent le dépôt officiel dans votre configuration apt.
Étape 2 : Installer les paquets Docker
Une fois le dépôt configuré, installez la dernière version stable de Docker Engine :
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Cette commande installe cinq composants clés :
- docker-ce : le moteur Docker lui-même
- docker-ce-cli : l’interface en ligne de commande
- containerd.io : le runtime de conteneurs
- docker-buildx-plugin : le plugin pour construire des images multi-architectures
- docker-compose-plugin : le plugin Docker Compose intégré
Comment installer une version spécifique de Docker Engine ?
Si votre environnement exige une version précise, listez d’abord les versions disponibles :
$ apt list --all-versions docker-ce
Puis installez la version souhaitée :
$ VERSION_STRING=5:29.5.3-1~ubuntu.24.04~noble
$ sudo apt install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
Étape 3 : Vérifier que Docker fonctionne correctement
Après l’installation, assurez-vous que le service Docker est bien actif :
$ sudo systemctl status docker
Si Docker n’est pas démarré, lancez-le manuellement :
$ sudo systemctl start docker
Vérifiez ensuite que l’installation est réussie en exécutant l’image de test hello-world :
$ sudo docker run hello-world
Cette commande télécharge une image de test, l’exécute dans un conteneur et affiche un message de confirmation. Si ce message s’affiche, votre installation est opérationnelle.
Quelles sont les autres méthodes pour installer Docker sur Ubuntu ?
Comment installer Docker sur Ubuntu via un fichier .deb ?
Si votre serveur n’a pas accès à Internet, vous pouvez télécharger manuellement les paquets .deb depuis https://download.docker.com/linux/ubuntu/dists/, en sélectionnant votre version d’Ubuntu et l’architecture appropriée.
Téléchargez les fichiers suivants :
containerd.io_<version>_<arch>.debdocker-ce_<version>_<arch>.debdocker-ce-cli_<version>_<arch>.debdocker-buildx-plugin_<version>_<arch>.debdocker-compose-plugin_<version>_<arch>.deb
Installez-les ensuite avec dpkg :
$ sudo dpkg -i ./containerd.io_<version>_<arch>.deb \
./docker-ce_<version>_<arch>.deb \
./docker-ce-cli_<version>_<arch>.deb \
./docker-buildx-plugin_<version>_<arch>.deb \
./docker-compose-plugin_<version>_<arch>.deb
Peut-on utiliser le script de commodité de Docker pour une installation rapide ?
Oui. Docker propose un script d’installation automatisé disponible sur https://get.docker.com/. Il détecte votre distribution Linux et configure automatiquement les paquets nécessaires.
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh
Attention : Ce script est recommandé uniquement pour les environnements de développement et de test. Il ne convient pas aux environnements de production, car il installe la dernière version stable sans possibilité de personnalisation avancée, et n’est pas conçu pour mettre à jour une installation existante.
Comment configurer Docker après l’installation sur Ubuntu ?
L’installation est terminée, mais quelques étapes post-installation optimisent votre environnement de travail.
Comment exécuter Docker sans sudo sur Ubuntu ?
Par défaut, le daemon Docker s’exécute en tant que root. Pour éviter de préfixer chaque commande Docker par sudo, ajoutez votre utilisateur au groupe docker :
- Créez le groupe
docker(s’il n’existe pas déjà) :
$ sudo groupadd docker
- Ajoutez votre utilisateur au groupe :
$ sudo usermod -aG docker $USER
- Déconnectez-vous puis reconnectez-vous pour que les changements prennent effet. Vous pouvez aussi exécuter :
$ newgrp docker
- Vérifiez que Docker fonctionne sans
sudo:
$ docker run hello-world
Important : Le groupe
dockeraccorde des privilèges équivalents à ceux deroot. Ajoutez uniquement des utilisateurs de confiance à ce groupe. Consultez la documentation sur la surface d’attaque du daemon Docker pour les implications en termes de sécurité.
Comment configurer Docker pour démarrer automatiquement au boot sur Ubuntu ?
Sur Ubuntu 22.04, 24.04 et 26.04, le service Docker démarre automatiquement au boot. Si ce n’est pas le cas, activez-le avec systemd :
$ sudo systemctl enable docker.service
$ sudo systemctl enable containerd.service
Pour désactiver ce comportement :
$ sudo systemctl disable docker.service
$ sudo systemctl disable containerd.service
Comment mettre à jour Docker Engine sur Ubuntu ?
La mise à jour de Docker Engine suit la même procédure que l’installation initiale. Puisque le dépôt officiel est déjà configuré, exécutez simplement :
$ sudo apt update
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Pour une version spécifique, reprenez la procédure de l’étape 2 en spécifiant le numéro de version souhaité.
Comment désinstaller Docker Engine sur Ubuntu ?
Si vous devez repartir d’une installation propre, voici la procédure complète de désinstallation.
- Supprimez les paquets Docker :
$ sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
- Supprimez les images, conteneurs et volumes :
$ sudo rm -rf /var/lib/docker
$ sudo rm -rf /var/lib/containerd
- Supprimez les fichiers de configuration du dépôt :
$ sudo rm /etc/apt/sources.list.d/docker.sources
$ sudo rm /etc/apt/keyrings/docker.asc
Les fichiers de configuration personnalisés doivent être supprimés manuellement.
Passez à l’étape suivante avec Docker sur Ubuntu
Vous disposez maintenant d’une installation Docker propre, sécurisée et prête à l’emploi sur Ubuntu. Chaque étape de ce guide s’appuie sur la documentation officielle Docker pour vous garantir une base solide.
La prochaine étape ? Construire votre première image, orchestrer vos conteneurs avec Docker Compose, ou explorer Docker BuildKit pour des builds multi-architectures. Les possibilités sont vastes.
Pour approfondir, consultez le workshop officiel Docker une ressource incontournable pour maîtriser la conteneurisation de bout en bout.
FAQ : Installer Docker sur Ubuntu
Quelle est la différence entre Docker Engine et Docker Desktop sur Ubuntu ?
Docker Engine est le moteur de conteneurisation en ligne de commande, idéal pour les serveurs et les environnements de production. Docker Desktop est une application graphique qui embarque Docker Engine, Docker Compose, et des outils supplémentaires. Docker Desktop est recommandé pour les postes de développement, Docker Engine pour les serveurs.
Peut-on installer Docker sur Ubuntu sans connexion Internet ?
Oui. Téléchargez les fichiers .deb correspondant à votre version d’Ubuntu depuis download.docker.com, puis installez-les manuellement avec dpkg -i. Cette méthode requiert de répéter l’opération à chaque mise à jour.
Pourquoi ne pas utiliser le paquet docker.io disponible dans les dépôts Ubuntu ?
Le paquet docker.io est maintenu par Ubuntu, pas par Docker Inc. Il est souvent en retard sur les dernières versions et peut manquer de fonctionnalités récentes. Pour une installation à jour et officiellement supportée, utilisez toujours les dépôts officiels de Docker.
Comment vérifier la version de Docker installée sur Ubuntu ?
Exécutez la commande suivante dans votre terminal :
$ docker --version
Pour des informations détaillées sur le système Docker, utilisez docker info.
Le script de commodité get.docker.com est-il sûr à utiliser ?
Le script est open source et maintenu par Docker Inc. sur GitHub. Avant de l’exécuter, vous pouvez inspecter son contenu ou simuler son exécution avec l’option --dry-run. Cela dit, réservez-le aux environnements de développement en production, la méthode via le dépôt apt offre bien plus de contrôle.
