Guide étape par étape : Installation de Docker Desktop sur Windows et macOS

Docker Desktop est le point de départ habituel lorsque vous souhaitez exécuter des conteneurs sur un ordinateur portable Windows ou macOS. L'installation est simple, mais quelques paramètres système peuvent empêcher Docker de démarrer après la fin de l'installateur.

Ce guide vous accompagne dans l'installation de Docker Desktop sur Windows et macOS, puis vérifie que la CLI Docker, le moteur Docker et un conteneur de test fonctionnent correctement.

Ce que Docker Desktop installe

Docker Desktop vous offre un environnement Docker local avec la CLI Docker, le moteur Docker, Docker Compose, un tableau de bord de bureau et un support Kubernetes optionnel. Sous Windows, Docker Desktop exécute normalement des conteneurs Linux via WSL 2. Sous macOS, il exécute des conteneurs à l'intérieur d'une machine virtuelle Linux légère.

Pour le développement quotidien, cela signifie que vous pouvez exécuter des commandes telles que :

docker run hello-world
docker compose up
docker build -t my-app .

Vous n'avez pas besoin d'installer un package de moteur Docker séparé au préalable.

Vérifiez d'abord les prérequis

Docker modifie les exigences de plateforme au fil du temps, alors consultez la documentation actuelle de Docker avant d'installer sur des machines plus anciennes. Dans la plupart des configurations actuelles, vous devez confirmer ces bases.

Prérequis Windows

Utilisez une édition Windows 64 bits prise en charge et maintenez Windows à jour. Docker Desktop fonctionne mieux avec le backend WSL 2, alors installez WSL avant ou pendant l'installation :

wsl --install

Exécutez cette commande depuis une invite PowerShell ou une invite de commandes élevée, puis redémarrez si Windows vous le demande.

Vérifiez également la virtualisation matérielle. Ouvrez le Gestionnaire des tâches, allez dans Performances, sélectionnez CPU, et cherchez Virtualisation : Activée. Si elle est désactivée, activez-la dans les paramètres de votre BIOS ou UEFI.

Docker Desktop est destiné aux environnements Windows de bureau, pas à Windows Server.

Prérequis macOS

Utilisez une version macOS prise en charge sur un Apple Silicon ou un Mac Intel. Téléchargez l'installateur correct pour votre type de puce. Si vous n'êtes pas sûr du Mac que vous possédez, ouvrez Menu Apple > À propos de ce Mac et vérifiez la ligne de la puce ou du processeur.

Docker Desktop a besoin de suffisamment de mémoire et d'espace disque pour exécuter une VM Linux et stocker des images. Si vous prévoyez d'exécuter des bases de données ou des piles multi-services localement, donnez plus de mémoire à Docker dans les paramètres après l'installation.

Installer Docker Desktop sur Windows

Téléchargez Docker Desktop depuis le site officiel de Docker. Évitez les miroirs de téléchargement tiers pour les outils de développement.

Exécutez l'installateur .exe et gardez l'option WSL 2 activée lorsqu'elle apparaît. Si l'installateur propose d'ajouter des composants Windows requis, autorisez-le. Après l'installation, redémarrez votre ordinateur si invité.

Ouvrez Docker Desktop depuis le menu Démarrer. Au premier lancement, acceptez les termes de la licence et laissez Docker terminer sa configuration. Si Docker signale un problème WSL, mettez à jour WSL et réessayez :

wsl --update

Si vous utilisez un ordinateur portable professionnel, les logiciels de sécurité des points de terminaison peuvent interférer avec la virtualisation ou la mise en réseau locale. Dans ce cas, vérifiez la politique Docker Desktop de votre entreprise avant de modifier les paramètres du pare-feu ou de l'antivirus.

Installer Docker Desktop sur macOS

Téléchargez Docker Desktop pour Mac depuis le site officiel de Docker. Choisissez l'installateur Apple Silicon pour les Macs de la série M et l'installateur Intel pour les Macs Intel.

Ouvrez le fichier .dmg, puis faites glisser Docker dans le dossier Applications. Lancez Docker depuis Applications. macOS peut demander votre mot de passe ou une autorisation pour installer des composants d'assistance utilisés pour la mise en réseau et la virtualisation.

Lorsque Docker Desktop démarre, attendez que l'icône de la barre de menu indique que Docker est en cours d'exécution. Le premier démarrage peut prendre plus de temps car Docker crée sa VM locale et son stockage.

Vérifier l'installation

Ouvrez un terminal et vérifiez le client et le serveur Docker :

docker version

Vous devriez voir à la fois une section client et une section serveur. Si vous ne voyez que des informations sur le client ou une erreur concernant la connexion au démon, Docker Desktop n'est pas encore en cours d'exécution ou a échoué à démarrer.

Exécutez le conteneur de test standard :

docker run hello-world

Docker télécharge une petite image et l'exécute. Une exécution réussie imprime un message expliquant que Docker fonctionne.

Vous pouvez également vérifier Docker Compose :

docker compose version

Utilisez la commande docker compose séparée par un espace pour Compose v2, qui est inclus avec Docker Desktop.

Ajuster les premiers paramètres

Ouvrez les paramètres de Docker Desktop après le premier test réussi.

Sous Windows, vérifiez Ressources > Intégration WSL et activez l'intégration pour les distributions Linux où vous exécutez des commandes de développement. Si vous utilisez Ubuntu dans WSL, cela vous permet d'exécuter docker depuis le shell Ubuntu.

Sous Windows et macOS, examinez Ressources. Les petits projets peuvent fonctionner correctement avec les valeurs par défaut, mais Kubernetes local, les bases de données et les grandes constructions nécessitent souvent plus de mémoire ou d'espace disque.

Activez Kubernetes uniquement si vous avez besoin d'un cluster local à un seul nœud. Le laisser désactivé maintient Docker Desktop plus léger.

Problèmes d'installation courants

Si Docker ne démarre pas sous Windows, confirmez d'abord que la virtualisation est activée et que WSL est installé :

wsl --status

Si WSL est obsolète, exécutez :

wsl --update

Si docker version ne peut pas se connecter au démon Docker, assurez-vous que Docker Desktop est en cours d'exécution et a terminé son démarrage. Sous macOS, vérifiez l'icône de la barre de menu. Sous Windows, vérifiez la zone de notification.

Si un conteneur de test ne peut pas atteindre le réseau, testez depuis un réseau ou un état VPN différent. Les clients VPN et les proxys d'entreprise affectent souvent la mise en réseau Docker. Docker Desktop dispose de paramètres de proxy que vous pouvez configurer lorsque votre environnement les nécessite.

Une fois que docker run hello-world fonctionne, votre environnement de conteneur local est prêt. Une bonne prochaine étape est d'exécuter un service que vous connaissez déjà, comme Nginx :

docker run --rm -p 8080:80 nginx

Ouvrez ensuite http://localhost:8080. Si vous voyez la page d'accueil de Nginx, Docker peut tirer des images, démarrer des conteneurs et publier des ports sur votre machine.