Installer Docker Engine sur Ubuntu.

Avant de commencer

Identifier précisément la machine

Cette procédure concerne Ubuntu 64 bits pris en charge par Docker. Les distributions dérivées peuvent fonctionner, mais elles ne sont pas officiellement couvertes par la même procédure.

lsb_release -a
dpkg --print-architecture

Étape 1

Rechercher les paquets susceptibles d’entrer en conflit

Docker demande de retirer certains paquets fournis par la distribution lorsqu’ils entrent en conflit avec Docker CE. Commencez uniquement par les lister : ne supprimez rien à l’aveugle.

dpkg -l | grep -E 'docker|containerd|runc|podman'

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

Étape 2

Installer les prérequis et la clé officielle

La clé permet à APT de vérifier que les paquets proviennent bien du dépôt Docker configuré.

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 3

Ajouter le dépôt APT Docker

Le fichier DEB822 ci-dessous sélectionne automatiquement le nom de code Ubuntu et l’architecture du PC.

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 4

Installer Docker Engine et Compose

Cette commande installe le moteur, la CLI, le runtime containerd ainsi que les plugins Buildx et Compose depuis le dépôt officiel.

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

Test réel

Vérifier le service et lancer hello-world

Sur Ubuntu, le service Docker démarre normalement automatiquement. Le test suivant télécharge une petite image officielle et exécute un conteneur de vérification.

sudo systemctl status docker
sudo docker version
sudo docker run --rm hello-world

Choix de sécurité

Conserver sudo ou activer le groupe docker

Par défaut, le socket Docker appartient à root. Utiliser sudo docker … reste explicite. L’ajout au groupe docker est plus pratique, mais ce groupe accorde des privilèges équivalents à des droits administrateur.

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

Réseau

Comprendre l’impact sur le pare-feu

Les ports publiés par Docker peuvent contourner certaines règles définies uniquement avec UFW ou firewalld. Ne publiez pas un port sur toutes les interfaces sans comprendre son exposition.

Si le test échoue

Les vérifications utiles

Validation

Vérifiez votre installation