Installer Docker proprement - Le guide complet pour chaque OS

Choisir la bonne méthode selon votre machine

Je commence toujours par cette question, parce qu’elle évite de suivre un tutoriel inadapté. Docker n’a pas une seule voie d’installation: sur un poste de travail moderne, Docker Desktop simplifie l’ensemble, alors que sur Linux serveur ou VM légère, Docker Engine reste souvent plus cohérent.

Le point que beaucoup ratent, c’est que Docker Desktop sur Linux ne se comporte pas comme Docker Engine: il ajoute une VM et crée son propre contexte Docker. La documentation officielle Docker insiste aussi sur un autre détail utile en entreprise, à savoir que l’usage commercial de Docker Desktop peut être soumis à licence selon la taille de l’organisation. Une fois ce choix clarifié, on peut vérifier si la machine est vraiment prête.

La vraie question suivante est donc simple: votre système coche-t-il les prérequis nécessaires pour la méthode choisie?

Préparer la machine avant l’installation

Avant de lancer un installateur, je vérifie toujours trois choses: la compatibilité système, les droits nécessaires et les composants qui peuvent créer un conflit. C’est souvent ici que se cachent les erreurs les plus frustrantes, alors qu’elles sont faciles à éviter.

• Sur Windows, activez la virtualisation matérielle dans le BIOS ou l’UEFI, puis vérifiez que WSL 2 est disponible. Docker Desktop supporte les éditions 64 bits récentes de Windows 10 et Windows 11, avec au minimum 8 Go de RAM pour un usage confortable.
• Sur macOS, assurez-vous d’utiliser une version encore prise en charge, avec au moins 4 Go de RAM. Sur Apple silicon, Rosetta 2 reste recommandé si certains outils en ligne de commande doivent encore l’utiliser.
• Sur Linux, je recommande de partir d’une distribution officiellement supportée et de supprimer les paquets Docker non officiels avant d’installer la version d’origine Docker. Les paquets qui posent le plus souvent problème sont docker.io, docker-compose, podman-docker et les anciens binaires containerd ou runc.
• Sur une machine exposée, pensez aussi au pare-feu. Quand Docker publie un port, il peut contourner certaines règles locales, ce qui mérite d’être anticipé plutôt que découvert après coup.

Quand ces prérequis sont validés, l’installation se déroule généralement sans surprise. Je peux alors passer à la procédure concrète, en commençant par la plateforme la plus fréquente dans les équipes frontend et backend: Windows.

Installer Docker sur Windows

Sur Windows, je recommande en priorité Docker Desktop en mode per-user si votre besoin est de développer des conteneurs Linux. C’est plus simple à maintenir, cela évite souvent les droits administrateur permanents et le backend WSL 2 suffit dans la majorité des cas.

1. Téléchargez l’installateur Docker Desktop depuis la page officielle de téléchargement.
2. Lancez Docker Desktop Installer.exe.
3. Choisissez le mode per-user si vous travaillez seul sur la machine et si vous n’avez pas besoin des conteneurs Windows.
4. Lors de l’assistant, laissez le backend WSL 2 si c’est le mode recommandé par votre configuration.
5. Terminez l’installation puis ouvrez Docker Desktop une première fois pour accepter les conditions d’utilisation et finaliser l’initialisation.

Si vous devez exécuter des conteneurs Windows, la logique change: il faut plutôt partir sur le mode all users, avec les bonnes éditions de Windows et, selon le cas, Hyper-V activé. Je le précise parce que ce point est souvent mal compris: les éditions Home et Education permettent surtout les conteneurs Linux, pas le scénario Windows containers le plus complet.

En entreprise, si l’installateur a été lancé avec un compte administrateur différent du compte d’usage, il faut aussi ajouter l’utilisateur au groupe docker-users pour accéder aux fonctions qui demandent plus de privilèges. Une fois cela fait, la suite logique consiste à faire la même vérification de base que sur les autres systèmes.

Une fois Windows couvert, le parcours macOS est plus court, mais il a ses propres détails de compatibilité.

Installer Docker sur macOS

Sur macOS, Docker Desktop reste la voie la plus directe. La procédure est simple, mais je garde deux vérifications en tête: la version de macOS doit être encore supportée, et il faut assez de mémoire pour éviter une machine qui rame dès qu’un second conteneur démarre.

1. Téléchargez l’image disque Docker.dmg.
2. Double-cliquez sur le fichier, puis faites glisser Docker dans le dossier Applications.
3. Lancez Docker.app depuis Applications.
4. Acceptez les conditions, puis choisissez soit les réglages recommandés, soit les réglages avancés si vous voulez maîtriser l’emplacement des outils CLI ou le socket Docker.
5. Si vous êtes sur Apple silicon et qu’un outil en ligne de commande le demande, installez Rosetta 2.

sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
sudo hdiutil detach /Volumes/Docker

Ce que j’apprécie sur macOS, c’est que l’installation reste très lisible pour un développeur qui veut juste lancer une stack locale et ne pas passer une heure à assembler des dépendances. Le seul vrai piège, c’est d’oublier qu’une ancienne version de macOS ou un manque de RAM suffit à transformer Docker en machine lente et pénible à utiliser.

Sur Linux, en revanche, le choix entre Desktop et Engine change vraiment le comportement de la machine, donc il mérite une section dédiée.

Installer Docker sur Linux

Sur Linux, je distingue clairement deux cas. Si vous voulez un environnement de travail minimal, un serveur ou une installation facile à automatiser, je pars sur Docker Engine. Si vous voulez une expérience de bureau plus guidée avec interface graphique, Docker Desktop sur Linux peut convenir, mais il faut accepter le fait qu’il tourne dans une VM et utilise son propre contexte desktop-linux.

La documentation officielle Docker recommande d’éviter les paquets non officiels et de passer par le dépôt officiel pour garder des mises à jour propres. Sur Ubuntu, une installation classique ressemble à ceci une fois le dépôt configuré:

sudo apt remove docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Après l’installation, je fais tout de suite deux choses: je vérifie que le service démarre correctement, puis j’autorise mon utilisateur à exécuter Docker sans passer systématiquement par sudo.

sudo usermod -aG docker $USER
newgrp docker
sudo systemctl enable docker.service
sudo systemctl enable containerd.service
docker run hello-world

Il faut quand même garder une lecture sécurité: le groupe docker donne des privilèges proches du root, donc sur une machine partagée je ne l’ajoute pas à la légère. Si je veux une approche plus restrictive, je regarde plutôt le mode rootless. Et si Docker Desktop est déjà installé sur Linux, je vérifie les contextes avec docker context ls pour éviter que Desktop et Engine se marchent dessus, surtout sur les ports publiés.

Une fois l’installation en place, la suite logique est de confirmer que le démon répond bien et que la CLI pointe au bon endroit.

Vérifier l’installation et corriger les pièges classiques

Je ne considère jamais l’installation terminée tant que les commandes de base n’ont pas répondu proprement. C’est le moment où l’on repère les vraies erreurs, pas celles que l’assistant d’installation a masquées.

docker --version
docker compose version
docker info
docker run hello-world

• docker: command not found indique en général que le paquet CLI n’est pas installé ou que le chemin n’est pas correct.
• permission denied signifie le plus souvent que votre utilisateur n’a pas encore rejoint le groupe docker. Déconnectez-vous, reconnectez-vous, ou lancez newgrp docker.
• Cannot connect to the Docker daemon veut dire que le service ne tourne pas encore. Sur Linux, sudo systemctl start docker règle souvent le problème.
• WSL 2 absent ou désactivé bloque Docker Desktop sur Windows. Dans ce cas, il faut activer la fonctionnalité, redémarrer, puis relancer Docker Desktop.
• Port déjà utilisé arrive souvent quand Docker Desktop et Docker Engine cohabitent sur la même machine Linux. Je vérifie alors les contextes et je coupe le service inutile.

Quand le test hello-world passe, vous avez déjà fait l’essentiel. Le reste consiste surtout à rendre l’environnement plus propre et moins fragile sur la durée.

Les réglages que je fais juste après pour éviter les mauvaises surprises

Après une installation réussie, je n’en reste jamais là. Un Docker bien installé peut quand même devenir pénible si on ne règle pas les points de maintenance et de sécurité de base.

• J’active le démarrage automatique du service sur Linux quand la machine sert régulièrement à lancer des conteneurs.
• Je garde un œil sur la rotation des logs, surtout si la machine héberge plusieurs services qui écrivent beaucoup.
• Je préfère les mises à jour régulières à une installation figée pendant des mois, parce que Docker évolue vite et que les correctifs de sécurité comptent.
• Sur une machine partagée, je réfléchis au mode rootless avant d’ouvrir trop largement l’accès au groupe docker.
• Si j’utilise Docker Desktop sur Linux, je vérifie que je ne laisse pas tourner en même temps un Docker Engine inutile, juste pour éviter les conflits de ressources.

En pratique, c’est cette discipline qui transforme une installation “qui marche” en environnement fiable pour le développement quotidien. Si vous retenez une seule logique, gardez celle-ci: choisir la bonne variante pour votre système, valider avec hello-world, puis verrouiller les droits et les mises à jour avant de commencer à travailler sérieusement.