Installation de Docker Desktop (Windows, macOS)

Comprendre Docker Desktop et ses composants

Docker Desktop constitue une solution tout-en-un spécialement conçue pour les environnements de développement sur Windows et macOS. Contrairement à Docker Engine qui s'exécute nativement sur Linux, Docker Desktop intègre une couche de virtualisation légère permettant d'exécuter le moteur Docker sur des systèmes d'exploitation qui ne supportent pas nativement les fonctionnalités de conteneurisation du noyau Linux. Cette application unifiée regroupe plusieurs composants essentiels qui fonctionnent de concert pour offrir une expérience de développement fluide et cohérente.

Les principaux composants inclus dans Docker Desktop comprennent le moteur Docker (Docker Engine) qui constitue le coeur du système, l'interface en ligne de commande Docker CLI permettant d'interagir avec le moteur via terminal, Docker Compose pour orchestrer des applications multi-conteneurs, et Docker BuildKit qui optimise la construction d'images. L'application intègre également une interface graphique intuitive offrant une visualisation claire des conteneurs, images, volumes et réseaux, ainsi que des outils de diagnostic et de configuration. Cette combinaison d'outils dans une seule application simplifie considérablement la prise en main de Docker pour les développeurs.

L'architecture sous-jacente de Docker Desktop varie selon le système d'exploitation. Sur macOS, Docker Desktop utilise une machine virtuelle légère basée sur HyperKit (un dérivé de xhyve) pour les Mac Intel, ou la virtualisation native pour les Mac Apple Silicon. Sur Windows, deux options de virtualisation sont disponibles : Hyper-V pour les éditions Pro, Enterprise ou Education, et WSL 2 (Windows Subsystem for Linux 2) qui est désormais l'approche privilégiée et disponible même sur Windows 10 Home. Cette couche de virtualisation permet d'exécuter un noyau Linux complet, nécessaire pour les fonctionnalités de conteneurisation, tout en préservant l'expérience native du système hôte.

Docker Desktop offre des fonctionnalités spécifiques qui le distinguent d'une simple installation de Docker Engine. Parmi celles-ci figurent l'intégration transparente avec le système de fichiers hôte, permettant de monter facilement des répertoires du système dans les conteneurs; des outils de développement comme le hot reload qui détecte automatiquement les changements dans le code source et met à jour les conteneurs en temps réel; un tableau de bord de surveillance des ressources utilisées par les conteneurs; et des extensions qui enrichissent les fonctionnalités de base. Ces caractéristiques font de Docker Desktop l'outil de prédilection pour le développement d'applications conteneurisées sur Windows et macOS.

Téléchargement et installation sur Windows

Le processus d'installation de Docker Desktop sur Windows commence par le téléchargement de l'installateur depuis le site officiel de Docker. Rendez-vous sur https://www.docker.com/products/docker-desktop et cliquez sur le bouton de téléchargement pour Windows. L'installateur est proposé sous forme d'un fichier exécutable (.exe) d'environ 500 Mo. Docker propose automatiquement la version appropriée pour votre système, mais veillez à vérifier que votre version de Windows est compatible : Windows 10 64-bit Pro, Enterprise ou Education (Build 18362 ou supérieur) pour utiliser Hyper-V, ou toute édition de Windows 10 64-bit (y compris Home) avec Build 19041 ou supérieur pour utiliser WSL 2.

Avant de lancer l'installation, assurez-vous que les prérequis système sont correctement configurés. Pour la méthode Hyper-V, cette fonctionnalité doit être activée dans Windows. Vous pouvez le faire en accédant au Panneau de configuration > Programmes > Activer ou désactiver des fonctionnalités Windows, puis en cochant la case Hyper-V. Pour la méthode WSL 2 (recommandée), vous devez d'abord installer WSL 2 en ouvrant PowerShell en mode administrateur et en exécutant la commande : wsl --install. Si votre version de Windows est antérieure à 2004, vous devrez suivre un processus manuel plus complexe décrit dans la documentation Microsoft pour WSL 2.

Une fois les prérequis satisfaits, lancez l'installateur Docker Desktop et suivez les instructions à l'écran. Durant l'installation, plusieurs choix vous seront proposés : l'ajout d'un raccourci sur le bureau, le démarrage automatique de Docker au démarrage de Windows, et surtout le choix du backend de virtualisation entre Hyper-V et WSL 2. Si les deux options sont disponibles sur votre système, privilégiez WSL 2 qui offre de meilleures performances, particulièrement pour le système de fichiers partagé. L'installation nécessite des privilèges administrateurs et peut prendre plusieurs minutes. Un redémarrage du système sera probablement requis pour finaliser la configuration, notamment si c'est la première activation de Hyper-V ou de WSL 2.

Après l'installation et le redémarrage, Docker Desktop se lance automatiquement et commence l'initialisation de son environnement. Une icône Docker apparaît dans la zone de notification (barre des tâches), indiquant le statut du service. Lors du premier démarrage, Docker effectue plusieurs opérations d'initialisation qui peuvent prendre quelques minutes : configuration de la machine virtuelle, téléchargement des composants nécessaires, et vérification de la connectivité. Une fenêtre de tutoriel peut s'afficher, vous guidant à travers les premières étapes d'utilisation. Ce guide peut être particulièrement utile pour les nouveaux utilisateurs de Docker.

Pour vérifier que l'installation s'est correctement déroulée, ouvrez un terminal (PowerShell ou Invite de commandes) et exécutez la commande : docker --version qui devrait afficher la version installée, puis docker run hello-world qui téléchargera une image test et exécutera un conteneur affichant un message de succès. Si ces commandes s'exécutent sans erreur, votre installation de Docker Desktop est fonctionnelle. En cas de problème, consultez les logs accessibles via l'icône Docker dans la barre des tâches > Troubleshoot > Diagnose & Feedback, qui fournissent des informations détaillées sur d'éventuelles erreurs de configuration.

Configuration WSL 2 sur Windows pour des performances optimales

L'utilisation de WSL 2 (Windows Subsystem for Linux 2) comme backend pour Docker Desktop représente l'approche privilégiée sur Windows en raison de ses performances supérieures et de sa compatibilité avec toutes les éditions de Windows 10 récentes. Pour configurer WSL 2 de manière optimale, commencez par vérifier qu'il est correctement installé et défini comme version par défaut en exécutant wsl --status dans PowerShell. Le résultat devrait indiquer "Default Version: 2". Si ce n'est pas le cas, définissez WSL 2 comme version par défaut avec la commande wsl --set-default-version 2.

L'intégration entre Docker Desktop et WSL 2 peut être configurée finement via les paramètres de l'application. Accédez aux préférences de Docker Desktop en cliquant sur l'icône Docker dans la barre des tâches, puis sélectionnez Settings > Resources > WSL Integration. Cette interface vous permet de choisir les distributions Linux installées sur WSL 2 avec lesquelles Docker doit s'intégrer. Activer l'intégration avec vos distributions de développement habituelles permettra d'exécuter les commandes Docker directement depuis ces environnements Linux, sans configuration supplémentaire. Cette fonctionnalité est particulièrement précieuse pour les développeurs travaillant dans un environnement mixte Windows/Linux.

La gestion des ressources allouées à WSL 2 impacte directement les performances de Docker Desktop. Par défaut, WSL 2 utilise une allocation dynamique de mémoire, mais vous pouvez définir des limites explicites pour optimiser l'équilibre entre les performances de Docker et les ressources disponibles pour Windows. Créez ou modifiez un fichier nommé .wslconfig dans votre répertoire utilisateur (C:\Users\VotreNom\.wslconfig) avec le contenu suivant :

[wsl2]
memory=8GB
processors=4
swap=2GB

Les performances du système de fichiers représentent un aspect critique de l'expérience Docker avec WSL 2. Pour maximiser les performances, gardez vos projets et fichiers Docker dans le système de fichiers WSL plutôt que dans le système de fichiers Windows. En pratique, cela signifie accéder à vos projets via le chemin /home/votre-utilisateur/projets depuis WSL plutôt que via /mnt/c/Users/VotreNom/projets. Cette approche peut multiplier par 5 à 20 les performances d'I/O, particulièrement pour les projets comportant de nombreux petits fichiers comme les applications Node.js. WSL 2 monte automatiquement les disques Windows, donc vous pouvez facilement copier vos projets depuis Windows vers le système de fichiers Linux.

Si vous utilisez des IDE ou éditeurs de code comme Visual Studio Code, configurez-les pour fonctionner directement avec WSL 2 afin de maximiser les performances. Visual Studio Code propose l'extension "Remote - WSL" qui permet d'exécuter l'éditeur sous Windows tout en utilisant le système de fichiers et l'environnement d'exécution de WSL 2. Cette configuration hybride offre le meilleur des deux mondes : l'interface graphique native de Windows avec les performances du système de fichiers Linux. Pour l'activer, installez l'extension depuis le marketplace de VS Code, puis ouvrez votre projet avec la commande code . exécutée depuis un terminal WSL dans le répertoire de votre projet.

Téléchargement et installation sur macOS

L'installation de Docker Desktop sur macOS commence par le téléchargement de l'application depuis le site officiel de Docker (https://www.docker.com/products/docker-desktop). Une attention particulière doit être portée à la version téléchargée, car Docker propose désormais deux variantes distinctes : une pour les Mac équipés de processeurs Intel (x86-64) et une autre spécifiquement optimisée pour les Mac Apple Silicon (M1, M2 et versions ultérieures). Le site détecte généralement automatiquement votre architecture, mais vérifiez que la version téléchargée correspond bien à votre matériel. Pour confirmer l'architecture de votre Mac, cliquez sur le menu Apple > A propos de ce Mac.

Une fois le fichier DMG téléchargé (environ 500 Mo), ouvrez-le et glissez l'icône Docker dans votre dossier Applications, comme pour toute application macOS standard. Après avoir copié les fichiers, lancez Docker Desktop depuis votre dossier Applications ou via Spotlight (Cmd+Espace). Lors du premier lancement, vous devrez autoriser l'installation d'éléments système additionnels nécessaires au fonctionnement de Docker. Ces composants requièrent des privilèges administrateur, vous devrez donc saisir votre mot de passe lorsque cela vous sera demandé. Docker installe notamment son framework de virtualisation et configure les permissions réseau nécessaires.

Durant l'initialisation, Docker Desktop configurera automatiquement sa machine virtuelle sous-jacente et ses composants. Ce processus peut prendre plusieurs minutes lors du premier démarrage. Une icône Docker apparaît dans la barre de menus, indiquant l'état du service : une animation pendant le démarrage, puis une icône fixe lorsque Docker est prêt à être utilisé. Un tutoriel de bienvenue peut s'afficher, offrant un guide interactif pour les premiers pas avec Docker. Ce tutoriel est particulièrement recommandé pour les nouveaux utilisateurs, car il couvre les concepts fondamentaux à travers des exemples pratiques.

Pour vérifier que l'installation s'est déroulée correctement, ouvrez Terminal et exécutez la commande docker --version qui devrait afficher la version installée. Complétez la vérification avec docker run hello-world qui télécharge une image test minimale et exécute un conteneur affichant un message de succès. Si ces commandes s'exécutent sans erreur, votre installation de Docker Desktop fonctionne correctement. En cas d'échec, vérifiez que Docker Desktop est bien en cours d'exécution en consultant l'icône dans la barre de menus, qui doit être active (non grisée).

La configuration post-installation sur macOS implique quelques ajustements pour optimiser les performances. Accédez aux préférences de Docker Desktop via l'icône dans la barre de menus > Preferences. Dans l'onglet Resources, vous pouvez ajuster la mémoire, CPU et espace disque alloués à la machine virtuelle Docker. Pour un environnement de développement standard, allouez au moins 4 Go de RAM et 2 CPU, davantage si vous travaillez avec des applications complexes ou des bases de données. L'onglet File Sharing permet de spécifier quels répertoires de votre Mac peuvent être montés dans des conteneurs. Par défaut, votre dossier utilisateur est partagé, mais vous pouvez ajouter d'autres emplacements selon vos besoins.

Optimisations spécifiques pour macOS Apple Silicon

Les Mac équipés de puces Apple Silicon (M1, M2 et leurs variantes) offrent des performances remarquables avec Docker Desktop grâce à l'hyperviseur natif intégré à macOS et optimisé pour cette architecture ARM64. Toutefois, certaines considérations spécifiques doivent être prises en compte pour une expérience optimale. La principale particularité concerne la compatibilité des images Docker, qui doivent idéalement être disponibles en version ARM64 pour une exécution native. Docker Desktop pour Apple Silicon inclut un mécanisme de virtualisation transparent (Rosetta 2 pour Docker) permettant d'exécuter des images x86-64 traditionnelles, mais avec une pénalité de performance variable selon les charges de travail.

Pour vérifier si une image dispose d'une variante ARM64 compatible avec votre Mac, utilisez la commande docker manifest inspect --verbose [nom-image]:[tag]. Dans la sortie, recherchez la présence de la section "platform" avec "architecture": "arm64". Les images multi-architecture (multi-arch) sont particulièrement précieuses dans ce contexte car elles permettent à Docker de sélectionner automatiquement la variante appropriée pour votre architecture. Heureusement, la plupart des images officielles sur Docker Hub sont désormais disponibles en format multi-arch, y compris les images de base populaires comme Alpine, Ubuntu, Python, Node.js et bien d'autres.

Lors de la création de vos propres images Docker sur un Mac Apple Silicon, le paramètre --platform devient particulièrement important. Par défaut, Docker buildx (le builder intégré à Docker Desktop) crée des images pour l'architecture locale (ARM64). Si vous devez garantir la compatibilité avec des serveurs x86-64 traditionnels, vous pouvez spécifier explicitement la plateforme cible : docker buildx build --platform linux/amd64,linux/arm64 -t votre-image:tag .. Cette commande créera une image multi-architecture compatible avec les deux architectures principales. Pour cette fonctionnalité avancée, assurez-vous que le nouveau builder Buildx est activé dans les paramètres expérimentaux de Docker Desktop.

Les performances du système de fichiers constituent historiquement un point faible de Docker sur macOS, particulièrement pour les applications manipulant de nombreux petits fichiers. Sur les Mac Apple Silicon, Docker Desktop utilise désormais virtiofs (sur macOS 12.5+) ou gRPC FUSE, offrant des performances nettement supérieures aux anciennes implémentations osxfs. Malgré ces améliorations, certaines optimisations restent recommandées : privilégier les volumes Docker natifs plutôt que les bind mounts pour les données fréquemment accédées; utiliser .dockerignore pour exclure les fichiers non nécessaires du contexte de build; et considérer des techniques comme le cache de dépendances dans des volumes dédiés pour les frameworks comme Node.js (node_modules) ou Python (virtualenv).

La gestion de la mémoire sur les Mac Apple Silicon mérite une attention particulière car ces systèmes utilisent une architecture de mémoire unifiée. Dans les préférences de Docker Desktop, onglet Resources, ajustez l'allocation de mémoire en tenant compte de votre charge de travail et de la mémoire totale disponible. Contrairement aux systèmes Intel où la règle générale était d'allouer 50% de la RAM disponible, les Mac Apple Silicon peuvent fonctionner efficacement avec des allocations plus conservatrices (25-30% de la RAM totale) grâce à leur architecture mémoire optimisée. Cette configuration permet de maintenir de bonnes performances Docker tout en préservant les ressources nécessaires aux autres applications de développement comme les IDE, navigateurs ou outils de conception.

Problèmes courants d'installation et leurs solutions

L'échec d'initialisation de la virtualisation constitue l'un des problèmes les plus fréquents lors de l'installation de Docker Desktop. Sur Windows, ce problème se manifeste généralement par un message d'erreur indiquant que Hyper-V ne peut pas être activé ou que la virtualisation n'est pas activée dans le BIOS/UEFI. La solution implique deux vérifications : d'abord, accédez au BIOS/UEFI au démarrage de l'ordinateur (généralement via F2, F10 ou Suppr) et assurez-vous que les options de virtualisation (VT-x, AMD-V, SVM ou Intel Virtualization Technology) sont activées; ensuite, pour les utilisateurs de Windows 10/11 Pro, Enterprise ou Education, vérifiez que les composants Hyper-V sont activés dans les fonctionnalités Windows. Pour les utilisateurs de Windows Home privilégiant WSL 2, exécutez wsl --update pour installer ou mettre à jour tous les composants nécessaires.

Sur macOS, les problèmes de permissions système représentent un obstacle courant. Docker Desktop nécessite certaines autorisations étendues pour gérer les réseaux virtuels et accéder aux fichiers partagés. Si vous rencontrez des messages d'erreur liés aux permissions après l'installation, accédez à Préférences Système > Sécurité et confidentialité > onglet Général, où vous devriez voir une notification concernant une extension système bloquée provenant de Docker. Cliquez sur "Autoriser" pour approuver l'extension. Sur macOS Catalina et versions ultérieures, Docker peut également nécessiter des permissions d'accès aux fichiers qui doivent être explicitement accordées via les dialogues d'autorisation du système ou dans Préférences Système > Sécurité et confidentialité > onglet Confidentialité > Accès complet au disque.

Les problèmes de connectivité réseau constituent une autre catégorie d'erreurs fréquentes après l'installation de Docker Desktop. Si vous ne parvenez pas à télécharger des images ou si les conteneurs ne peuvent pas accéder à Internet, plusieurs causes sont possibles. Vérifiez d'abord que votre pare-feu personnel ou d'entreprise n'est pas configuré pour bloquer Docker. Sur les réseaux d'entreprise utilisant des proxys HTTP/HTTPS, vous devrez configurer Docker pour utiliser ces proxys via les préférences de Docker Desktop > Resources > Proxies. Cette configuration doit inclure les paramètres du proxy (URL, port, éventuels identifiants) ainsi que les exceptions pour les adresses locales avec la notation no_proxy appropriée. Pour tester la connectivité, exécutez docker run --rm alpine ping -c 4 google.com qui devrait recevoir des réponses si la configuration réseau est correcte.

Les conflits de ports représentent un problème subtil mais frustrant, particulièrement dans les environnements de développement où plusieurs applications peuvent utiliser les mêmes ports. Docker Desktop configure plusieurs ports pour son fonctionnement interne, notamment le port 2375 (API Docker non sécurisée), 2376 (API Docker sécurisée par TLS), et des plages dynamiques pour la publication de ports de conteneurs. Si ces ports sont déjà utilisés par d'autres applications, Docker peut échouer silencieusement ou produire des erreurs cryptiques. Pour identifier les conflits potentiels, utilisez netstat -ano | findstr "2375 2376" sur Windows ou lsof -i :2375,2376 sur macOS pour vérifier si ces ports sont déjà occupés. La solution implique généralement d'arrêter les services conflictuels ou de reconfigurer Docker pour utiliser des ports alternatifs via le fichier daemon.json.

L'insuffisance de ressources système peut provoquer des comportements instables de Docker Desktop même après une installation apparemment réussie. Si vous constatez des crashs fréquents, une lenteur excessive ou des conteneurs qui s'arrêtent inopinément, vérifiez les ressources allouées dans les préférences de Docker Desktop > Resources. Les valeurs par défaut sont souvent conservatrices et peuvent être insuffisantes pour des charges de travail de développement réelles. Comme règle générale, allouez au moins 4 Go de RAM et 2 CPU pour un environnement de développement basique, davantage pour des environnements plus complexes incluant plusieurs bases de données ou services. Sur les systèmes avec moins de 8 Go de RAM totale, vous devrez trouver un équilibre délicat entre les ressources allouées à Docker et celles nécessaires au système d'exploitation et autres applications.

Pour diagnostiquer efficacement les problèmes persistants, Docker Desktop intègre des outils de diagnostic accessibles via l'icône Docker dans la barre des tâches/barre de menus > Troubleshoot > Diagnose & Feedback. Cette fonction collecte les logs système, la configuration Docker et les informations de diagnostic essentielles dans un rapport que vous pouvez sauvegarder localement ou partager avec le support. Les logs plus détaillés sont consultables directement : sur Windows, via %APPDATA%\Docker\log.txt et sur macOS, via le menu Docker > Troubleshoot > Collect diagnostics, open in Finder. L'analyse de ces logs révèle souvent des indices précieux sur la source exacte du problème, qu'il s'agisse de conflits de configuration, de limites de ressources ou d'interférences avec d'autres logiciels système.

Configuration post-installation et personnalisation

La configuration du démarrage automatique constitue l'un des premiers paramètres à ajuster après l'installation de Docker Desktop. Par défaut, l'application est configurée pour démarrer automatiquement lors de la connexion utilisateur, ce qui garantit la disponibilité immédiate des services Docker pour le développement. Cependant, cette configuration peut ralentir le démarrage du système et consommer des ressources même lorsque vous ne développez pas activement. Pour modifier ce comportement, accédez aux paramètres de Docker Desktop > General et ajustez l'option "Start Docker Desktop when you log in". Cette option peut être particulièrement pertinente à désactiver sur les ordinateurs portables fonctionnant sur batterie ou disposant de ressources limitées, permettant de démarrer Docker manuellement uniquement lorsque nécessaire.

Les paramètres de ressources peuvent être affinés pour optimiser les performances de Docker en fonction de votre charge de travail spécifique. Dans les préférences > Resources, vous pouvez ajuster l'allocation de mémoire RAM, le nombre de CPU virtuels, l'espace disque pour les images et données Docker, ainsi que la taille du fichier d'échange (swap). Ces paramètres ont un impact direct sur les performances : une allocation trop restrictive limitera les performances des conteneurs, tandis qu'une allocation trop généreuse peut affecter les performances globales du système. Un bon équilibre consiste généralement à allouer environ 50% de la RAM disponible et 50% des coeurs CPU sur un système dédié au développement. Pour l'espace disque, prévoyez au moins 20-30 Go pour un usage standard, davantage si vous travaillez avec de nombreuses images volumineuses.

La configuration des registres Docker personnalisés peut considérablement accélérer les workflows de développement en entreprise. Par défaut, Docker Desktop utilise Docker Hub comme registry principal, mais vous pouvez ajouter des registres privés ou d'entreprise. Pour configurer un registry privé avec authentification, utilisez la commande docker login votre-registry.exemple.com qui stockera de manière sécurisée vos identifiants. Pour les registres nécessitant des certificats TLS personnalisés (souvent le cas dans les environnements d'entreprise avec PKI interne), ajoutez ces certificats dans Docker Desktop > Settings > Docker Engine, en modifiant la configuration JSON pour inclure :

{"insecure-registries": [], "registry-mirrors": ["https://mirror.exemple.com"]}

L'intégration avec les outils de développement peut être configurée pour améliorer votre workflow quotidien. Docker Desktop s'intègre nativement avec Visual Studio Code via l'extension Docker officielle, permettant de gérer conteneurs, images et Docker Compose directement depuis l'IDE. Pour activer cette intégration, installez l'extension depuis le marketplace VS Code et assurez-vous que Docker Desktop est en cours d'exécution. De même, l'extension Remote Containers permet de développer directement dans un conteneur, isolant parfaitement votre environnement de développement. Pour les utilisateurs de JetBrains IDEs (IntelliJ, PyCharm, etc.), des plugins Docker dédiés offrent des fonctionnalités similaires. Ces intégrations éliminent le besoin de basculer constamment entre votre IDE et le terminal ou l'interface Docker, accélérant considérablement les cycles de développement.

La personnalisation de l'expérience utilisateur Docker Desktop peut être réalisée à travers plusieurs paramètres additionnels. L'option "Use Docker Compose V2" dans l'onglet General est recommandée pour bénéficier de meilleures performances et nouvelles fonctionnalités. L'activation de BuildKit dans les paramètres expérimentaux accélère considérablement la construction d'images avec des fonctionnalités avancées comme la parallélisation des étapes de build et le cache intelligent. Pour réduire l'encombrement visuel, vous pouvez configurer quelles notifications Docker Desktop doit afficher via l'onglet Notifications. Enfin, les utilisateurs avancés apprécieront la possibilité de personnaliser directement la configuration du daemon Docker en modifiant le fichier JSON accessible via Settings > Docker Engine, permettant d'ajuster des paramètres fins comme les quotas de logging, les options de stockage ou les paramètres de réseau.

La mise en place d'une stratégie de maintenance proactive pour Docker Desktop garantit des performances optimales dans la durée. Programmez régulièrement des opérations de nettoyage via l'option "Clean / Purge data" dans l'onglet Troubleshoot pour éliminer les images, conteneurs et volumes inutilisés qui s'accumulent inévitablement. Activez les mises à jour automatiques dans l'onglet Software Updates pour bénéficier des dernières améliorations de performance et correctifs de sécurité. Pour les environnements de production ou pré-production, envisagez de créer un script de maintenance qui exécute périodiquement des commandes comme docker system prune -af pour libérer l'espace disque occupé par les ressources inutilisées. Cette discipline de maintenance préventive évite les surprises désagréables comme l'épuisement soudain de l'espace disque au milieu d'un sprint de développement critique.