Comment installer Docker sur Ubuntu : tutoriel complet étape par étape

Installer Docker sur Ubuntu n’est pas toujours une sinécure, surtout si des éléments se bloquent ou refusent de fonctionner immédiatement. Vous avez peut-être essayé de l’installer, mais des commandes comme docker ne sont pas reconnues ou les conteneurs refusent de se connecter ; quel problème ! Ce guide présente les méthodes les plus courantes, des installations officielles aux paquets hors ligne, ainsi que des conseils pour résoudre les problèmes et nettoyer les anciennes versions. Car, bien sûr, Linux a tendance à rendre les choses plus compliquées qu’elles ne le devraient. Une fois installé, vous pourrez exécuter des conteneurs, tester des éléments localement ou même déployer en production. Attendez-vous à une configuration Docker fonctionnelle sans difficulté, et à quelques pistes en cas de problème.

Comment résoudre les problèmes d’installation et d’exécution de Docker sur Ubuntu

Assurez-vous qu’aucun package Docker conflictuel ou obsolète ne perturbe les choses

Tout d’abord, il est rare que les paquets restants ne causent pas de problèmes par la suite. Supprimez tout ce qui pourrait gêner :

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove -y "$pkg" done 

Cela permet de clarifier les choses. Parfois, des versions anciennes ou des outils en conflit provoquent des erreurs de commande introuvable ou des problèmes de démarrage du démon. Sur certaines configurations, un redémarrage ultérieur peut enfin synchroniser les choses.

Vérifiez votre version et votre architecture Ubuntu – connaissez votre environnement

Avant de lancer les commandes, vérifiez que votre système d’exploitation et l’architecture de votre processeur sont conformes à vos attentes. Exécutez :

source /etc/os-release && echo "Ubuntu codename: ${UBUNTU_CODENAME:-$VERSION_CODENAME}" dpkg --print-architecture 

Cela confirme simplement que vous travaillez avec les bonnes versions de référentiel et de package. Parfois, une mauvaise architecture entraîne des installations interrompues ou des packages incompatibles.

Méthode 1 : installer Docker depuis le référentiel APT officiel

C’est la solution idéale pour la plupart des utilisateurs recherchant une configuration stable et facile à gérer. Vous obtenez la dernière version officielle de Docker avec les mises à jour directement depuis la source. Cela permet d’éviter les dépendances.

Installer les packages requis et ajouter la clé GPG

Cette étape installe des outils comme ca-certificates et curl, et ajoute la clé GPG de Docker. C’est assez simple, mais l’omission d’une étape ici peut empêcher apt de vérifier que vous récupérez des paquets Docker légitimes, ce qui est problématique.

sudo apt-get update sudo apt-get install -y 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 référentiel officiel de Docker

C’est ici que vous indiquez à votre système où trouver les paquets Docker. C’est une commande echo simple, mais veillez à remplacer correctement $(./etc/os-release && echo « ${UBUNTU_CODENAME} ») ; il arrive que le développement ne soit pas optimal, surtout si votre système d’exploitation n’est pas standard.

echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(./etc/os-release && echo "${UBUNTU_CODENAME}") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update 

Installer Docker Engine et les outils CLI

Il ne vous reste plus qu’à installer les conteneurs et l’interface CLI. En général, cela fonctionne correctement, mais si votre configuration est particulière, vous devrez peut-être spécifier des numéros de version spécifiques ou vérifier les dépendances endommagées.

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

Vérifiez que Docker est installé et en cours d’exécution

Si cela ne donne pas d’erreur, vérifiez l’état du démon :

sudo systemctl status docker --no-pager docker run hello-world 

Ce test extrait une petite image et l’exécute. Si cela fonctionne, votre configuration Docker est globalement correcte. Sur certaines machines, vous devrez peut-être ajouter votre utilisateur au groupe Docker pour plus de commodité :

sudo usermod -aG docker $USER newgrp docker docker run hello-world 

Je ne sais pas pourquoi, mais parfois, un nouveau groupe ou une nouvelle connexion est nécessaire pour que les modifications de groupe prennent effet sans redémarrage.

Mise à niveau ou installation de versions spécifiques de Docker

Si vous avez besoin d’une version particulière, vérifiez celles disponibles avec :

apt-cache madison docker-ce | awk '{ print $3 }' 

Ensuite installez votre choix comme :

sudo apt-get install -y docker-ce=<version> docker-ce-cli=<version> containerd.io 

Parce que parfois, vous avez simplement besoin de cette version spécifique pour des raisons de compatibilité. Sachez que sur certaines configurations, les rétrogradations ou les versions spécifiques peuvent devenir délicates si les référentiels ne sont pas mis à jour.

Méthode 2 : Installation hors ligne via des packages.deb

Idéal lorsque les serveurs sont isolés ou que l’accès à Internet est instable. Vous devez d’abord récupérer tous les fichiers, puis les installer localement.

Télécharger les packages Docker manuellement

Accédez au dépôt Ubuntu de Docker et sélectionnez votre architecture (par exemple, amd64 ou arm64 ).Récupérez ces fichiers.deb :

  • 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

Une fois téléchargé, installez tout d’un coup :

sudo dpkg -i./containerd.io_*_*.deb \./docker-ce_*_*.deb \./docker-ce-cli_*_*.deb \./docker-buildx-plugin_*_*.deb \./docker-compose-plugin_*_*.deb 

Cela semble un peu plus compliqué, mais c’est la seule option sans Internet, et sur certains systèmes, cela fonctionne de manière plus fiable.

Méthode 3 : Utilisation du script de commodité officiel de Docker

Si la vitesse est plus importante que la sécurité (non recommandé pour la production !), exécutez simplement :

curl -fsSL https://get.docker.com -o get-docker.sh sudo sh./get-docker.sh --dry-run # preview, then run without --dry-run sudo sh./get-docker.sh 

Cette méthode télécharge et configure tout sans difficulté. L’inconvénient ? Aucun contrôle sur les versions ou les dépendances, et elle est peu pratique pour les systèmes critiques.

Installation de Docker Desktop sur Ubuntu

Pour une expérience utilisateur simplifiée avec Docker, Desktop ajoute une couche de simplicité d’utilisation, un peu comme Docker dans la barre d’état système. Vous aurez besoin d’Ubuntu 22.04 ou d’une version ultérieure, avec GNOME Terminal si vous n’utilisez pas GNOME.

Configurer le dépôt Desktop et l’installer

Répétez essentiellement la configuration du référentiel de la méthode 1, mais installez ensuite :

sudo apt-get install -y./docker-desktop-amd64.deb 

Démarrez-le et activez-le pour le lancement automatique :

systemctl --user start docker-desktop systemctl --user enable docker-desktop 

Vérifications post-installation et dépannage courant

docker run hello-world docker run -d -p 8080:80 --name web nginx docker ps sudo systemctl enable docker 

Quelques problèmes typiques :

  • docker: command not found→ Réinstallez Docker CLI ou vérifiez que votre PATH inclut /usr/bin ou /usr/local/bin.
  • Impossible de se connecter au démon → Assurez-vous que le service Docker est opérationnel et que votre utilisateur fait partie du groupe Docker.
  • Échecs d’extraction d’image → Vérifiez les paramètres réseau, le proxy, le DNS ou la synchronisation horaire (NTP).Il arrive que Docker ne parvienne pas à atteindre Docker Hub.
  • Problèmes de pare-feu → Vous devrez peut-être ajouter des règles dans la chaîne DOCKER-USER ou dans votre pare-feu pour autoriser le trafic du port du conteneur.

Désinstaller Docker si nécessaire

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

Conclure

Installer Docker sur Ubuntu peut sembler complexe, surtout avec tous les éléments en jeu : versions du noyau, dépendances, pare-feu. Mais une fois opérationnel, il est assez performant pour la gestion des conteneurs. Les méthodes officielles couvrent quasiment tous les scénarios, des installations en ligne aux configurations hors ligne, et des étapes de dépannage permettent généralement de résoudre les problèmes. Si l’installation fonctionne enfin, c’est un soulagement ; vous pourrez commencer à créer ou à déployer des conteneurs quasiment immédiatement.

Résumé

  • Supprimez d’abord les packages en conflit
  • Choisissez la bonne méthode d’installation en fonction de votre environnement
  • Vérifiez que Docker fonctionne avec un test de conteneur rapide
  • Maintenez Docker à jour et vérifiez les règles du pare-feu si nécessaire
  • Supprimez proprement les anciennes configurations en cas de changement de méthode

Croisons les doigts pour que cela aide