Installer Docker
Procédure d’installation et de vérification de Docker sur Ubuntu.
Créé le 5 novembre 2025
Mis à jour le 10 novembre 2025
Introduction
Docker est une plateforme de conteneurisation qui permet d’exécuter des applications dans des environnements isolés et reproductibles appelés conteneurs.
Chaque conteneur embarque tout ce dont une application a besoin : code, dépendances, librairies, et configuration système.
Docker simplifie ainsi le déploiement en garantissant que l’application fonctionne de la même façon, que ce soit sur un poste de développement ou sur un serveur de production.
Docker Compose, quant à lui, est un outil qui permet de définir et gérer plusieurs conteneurs à l’aide d’un unique fichier docker-compose.yml.
Il facilite la création d’environnements complets (backend, base de données, frontend, etc.) en automatisant leur lancement et leur orchestration avec une seule commande.
Installation
Sur Ubuntu, la méthode recommandée consiste à ajouter le dépôt officiel Docker, importer la clé GPG et installer les paquets officiels fournis par Docker.
Les commandes ci-dessous sont à exécuter depuis un terminal avec un compte disposant des droits sudo.
Tout d'abord, mettez le système à jour puis installez les dépendances requises :
sudo apt update && sudo apt upgrade -y sudo apt install -y ca-certificates curl gnupg lsb-release
Ensuite, créez le dossier pour la clé APT, importez la clé officielle et donnez les permissions nécessaires :
sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo tee /etc/apt/keyrings/docker.gpg > /dev/null sudo chmod a+r /etc/apt/keyrings/docker.gpg
Ajoutez ensuite le dépôt Docker à vos sources APT puis installez Docker Engine et les plugins officiels :
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \ https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" \ | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Vérifier que Docker fonctionne
Vérifiez que le service Docker est actif :
sudo systemctl status docker
Si nécessaire, démarrez le service :
sudo systemctl start docker
Testez l'installation avec l'image de démonstration officielle :
docker run --rm hello-world
Si vous voyez un message de bienvenue, l'installation est réussie.
Utiliser Docker sans sudo
Pour exécuter Docker en tant qu'utilisateur non-root, ajoutez votre compte au groupe docker.Cette opération évite d'utiliser sudo pour chaque commande Docker.
sudo usermod -aG docker $USER newgrp docker
Vérifiez ensuite que Docker est accessible sans sudo :
docker compose version
Windows (Docker Desktop + WSL2)
🔗 Installer Linux sur Windows avec WSL
Sur Windows, il est nécessaire d'installer WSL2 puis Docker Desktop avec l'intégration WSL activée. WSL2 améliore la compatibilité des volumes et les performances des conteneurs avec votre système d'exploitation.
Installez WSL depuis PowerShell (exécuté en administrateur) :
wsl --install
Redémarrez si nécessaire, puis installez Docker Desktop depuis le site officiel.
Attention, pendant l'installation : activez l'option WSL2.
Après installation, ouvrez Docker Desktop et activez l'intégration WSL pour la distribution souhaitée (Settings > Resources > WSL Integration).
Vérifiez l'installation dans PowerShell :
docker --version docker compose version
Si Docker Desktop était installé avant WSL, désinstallez-le puis réinstallez-le après l'installation de WSL pour garantir une intégration correcte.