Comment installer Docker sur Windows 11 : un guide de 5 minutes (2025)

Votre tremplin de 5 minutes vers Docker sur Windows 11

Docker est une plateforme ouverte qui a fondamentalement changé le développement de logiciels modernes. Elle s'appuie sur la conteneurisation pour regrouper les applications et leurs dépendances dans des unités légères, isolées et portables appelées conteneurs. This technology elegantly solves the classic and often frustrating “it works on my machine” problem by ensuring that an application runs consistently across development, testing, and production environments. À la fin de ce guide complet, tout développeur ou passionné de technologie disposera d'un environnement Docker entièrement fonctionnel sur son PC Windows 11, prêt à créer, partager et exécuter des applications conteneurisées en toute confiance.   

The “5-minute” claim in the title refers specifically to the active installation and command execution time a user will spend. It is important to set realistic expectations: passive waiting periods for software downloads, system reboots, and the initial, one-time setup of the Windows Subsystem for Linux (WSL) are not included in this estimate. Ce guide est structuré de manière à rendre le processus actif aussi rapide et exempt d'erreurs que possible en abordant d'emblée les conditions préalables de manière approfondie.  

Ce rapport fournit une feuille de route complète pour le processus d'installation. Il commence par une vérification critique des exigences du système avant le vol, passe à l'installation de WSL 2 et de Docker Desktop, couvre la vérification de la configuration et se termine par le lancement d'un conteneur de serveur web Nginx pratique et réel.   

Pour commencer, il est utile de comprendre quelques concepts fondamentaux de Docker. Un Image est un modèle en lecture seule qui contient le code de l'application, un moteur d'exécution, des outils système et toutes les dépendances nécessaires. A   

Conteneur est une instance vivante d'une image. Il s'agit de l'environnement autonome dans lequel l'application s'exécute.   

Bureau Docker est une application facile à installer pour Windows qui regroupe le moteur Docker (le service principal en arrière-plan, ou démon), l'interface de ligne de commande (CLI) pour interagir avec lui et d'autres outils essentiels dans un seul paquet convivial. Le principal avantage de cet écosystème est la cohérence qu'il apporte, ce qui accélère considérablement les processus de développement et réduit les bogues liés à l'environnement.   

Liste de contrôle avant le vol : Votre PC Windows 11 est-il prêt pour Docker ?

Dedicating a few minutes to this pre-flight checklist is the single most important step to ensure a smooth and rapid installation. This section is designed to proactively address the most common points of failure, preventing hours of troubleshooting cryptic error messages later. A significant number of installation failures are not due to Docker itself but stem from a cascade of underlying system misconfigurations. For instance, a disabled virtualization setting in the computer’s firmware will prevent the Windows Subsystem for Linux (WSL 2) from functioning correctly. This, in turn, will cause the Docker Desktop installation to fail with vague errors like “Unexpected WSL error” or “This app can’t run on your PC”. Cette liste de contrôle brise cette chaîne d'échecs avant qu'elle ne commence, transformant une expérience potentiellement frustrante en une expérience simple.   

Analyse approfondie de la configuration requise

Avant de poursuivre, il est essentiel de confirmer que la machine hôte répond à la configuration système officielle pour Docker Desktop sur Windows 11. Les dernières exigences sont les suivantes :   

• Système d'exploitation : Une version 64 bits de Windows 11 est requise. Il peut s'agir de l'édition Home, Pro, Enterprise ou Education. Il est fortement recommandé d'utiliser la version 22H2 ou une version supérieure pour une meilleure compatibilité et de meilleures performances.
• Processeur : Le système doit être équipé d'un processeur 64 bits avec traduction d'adresses de second niveau (SLAT). Presque tous les processeurs modernes fabriqués au cours de la dernière décennie intègrent cette fonction.
• RAM : Un minimum de 4 Go de mémoire vive est nécessaire. Cependant, pour une expérience fluide et réactive, 8GB de RAM ou plus est fortement recommandé. Docker Desktop et les conteneurs qu'il exécute consomment de la mémoire, et 4 Go peuvent devenir un goulot d'étranglement important pendant le développement.   

L'étape la plus critique : Activation de la virtualisation du matériel

Docker on Windows does not run applications natively; it relies on hardware virtualization to run a lightweight Linux kernel through WSL 2. If this feature is disabled in the system’s BIOS/UEFI, Docker Desktop cannot function.   

Comment vérifier si la virtualisation est activée

Une vérification rapide peut être effectuée sans redémarrer le système :

1. Presse Ctrl + Shift + Esc pour ouvrir le gestionnaire des tâches de Windows.
2. Naviguez jusqu'à la page Performance tabulation.
3. Sélectionner UNITÉ CENTRALE dans le panneau de gauche.
4. Sur le côté droit, cherchez le Virtualisation statut. S'il indique ActivéAucune autre action n'est nécessaire pour cette étape. S'il est indiqué Handicapésil doit être activé dans les paramètres du BIOS/UEFI avant de poursuivre.   

Comment activer la virtualisation dans le BIOS/UEFI ?

Pour activer la virtualisation, il faut redémarrer l'ordinateur et entrer dans les paramètres du micrologiciel. Les étapes exactes peuvent varier d'un fabricant d'ordinateurs à l'autre, mais le processus général est cohérent.

La méthode moderne pour accéder aux paramètres du microprogramme UEFI sous Windows 11 est la suivante :   

1. Ouvrir le Paramètres naviguez vers Systèmepuis sélectionnez Récupération.
2. Under the “Advanced startup” section, click the Redémarrer maintenant bouton.
3. L'ordinateur redémarre dans l'environnement de récupération Windows. À partir de là, sélectionnez Troubleshoot > Advanced options > UEFI Firmware Settings et cliquez sur Redémarrage.

La méthode traditionnelle consiste à appuyer sur une touche spécifique pendant la séquence de démarrage initiale. La touche correcte dépend du fabricant.   

Once inside the BIOS/UEFI menu, the virtualization setting is typically located under an “Advanced,” “CPU Configuration,” or “Security” tab. The option will be labeled as Technologie de virtualisation Intel (VT-x), AMD-Vou Mode SVM. Ce réglage doit être modifié en   

Activé. Après l'avoir activé, il est essentiel d'enregistrer les modifications et de quitter le BIOS/UEFI, ce qui entraînera le redémarrage de l'ordinateur.

Pour vous aider dans cette démarche, le tableau suivant répertorie les clés d'accès communes au BIOS/UEFI des principaux fabricants de PC.

Fabricant	Clés communes
Dell	F2, F12
HP	Esc, F10
Lenovo	F1, F2, Fn+F2
ASUS	F2, Del
MSI / Gigabyte	Del
Tableau 1 : Clés d'accès communes au BIOS/UEFI par fabricant, compilées à partir des guides de l'utilisateur et de la documentation d'assistance.

La fondation : Installation du sous-système Windows pour Linux (WSL 2)

Une fois les conditions préalables confirmées, l'étape suivante consiste à installer la base sur laquelle Docker fonctionnera : le Windows Subsystem for Linux, version 2 (WSL 2). Docker Desktop utilise WSL 2 comme backend pour exécuter des conteneurs Linux directement sur Windows, offrant des performances quasi-natives, des temps de démarrage plus rapides et une intégration supérieure du système de fichiers par rapport à l'ancien backend Hyper-V.   

L'installation à commande unique

Microsoft a simplifié l'installation du WSL 2 en une seule commande puissante.

1. Ouvrir Windows PowerShell ou Invite de commande avec des autorisations élevées en cliquant avec le bouton droit de la souris sur son icône dans le menu Démarrer et en sélectionnant Exécuter en tant qu'administrateur.
2. Exécutez la commande suivante : Extrait de codewsl --install

This one command automates several steps that previously had to be done manually. It enables the necessary “Virtual Machine Platform” and “Windows Subsystem for Linux” features, downloads the latest Linux kernel from Microsoft, sets WSL 2 as the default version, and installs the Ubuntu distribution of Linux by default.   

Redémarrage et configuration après l'installation

Une fois la commande terminée, un redémarrage du système est nécessaire pour finaliser l'installation des nouvelles fonctionnalités de Windows.Au redémarrage, une fenêtre de console pour Ubuntu s'ouvrira automatiquement pour compléter sa configuration initiale. Ce processus implique la création d'un nouveau nom d'utilisateur et d'un nouveau mot de passe UNIX. Il est important de noter que ces informations d'identification sont destinées à l'environnement Linux et qu'elles sont totalement distinctes des informations d'identification standard de Windows.   

L'événement principal : Installation de Docker Desktop

Avec WSL 2 en place, le système est maintenant prêt pour l'installation principale de Docker Desktop.

Téléchargement du programme d'installation correct

Le programme d'installation officiel doit être téléchargé directement depuis le site web de Docker afin de garantir son authenticité et d'obtenir la dernière version.   

L'architecture du système est un détail essentiel et souvent négligé. Le programme d'installation pour les processeurs Intel et AMD standard est le programme x86_64 (ou AMD64) version. Community forums are filled with reports from users who encountered an immediate “This app can’t run on your PC” error because they accidentally downloaded the ARM64 installer, which is intended for devices like the Surface Pro X. The download page’s user interface can sometimes be confusing, so it is vital to double-check that the correct version is being downloaded.   

Le processus d'installation

1. Localisez le fichier téléchargé Docker Desktop Installer.exe fichier.
2. Double-cliquez sur le programme d'installation pour le lancer. Il demandera les privilèges d'administrateur, qui sont nécessaires pour l'installation.  
3. L'écran principal de configuration présente un choix crucial. Veillez à ce que l'option “Use WSL 2 instead of Hyper-V”est cochée. Cela configure Docker pour qu'il utilise le backend moderne recommandé pour des performances optimales. L'option d'ajout d'un raccourci sur le bureau est une question de préférence de l'utilisateur.   

Permissions post-installation (L'option utilisateurs-docker Groupe)

Si les droits d'administrateur sont nécessaires pour l'installation, ils ne sont pas requis pour l'utilisation quotidienne de Docker. Cependant, pour qu'un compte d'utilisateur standard (non administrateur) puisse communiquer avec le démon Docker, il doit être ajouté au compte local utilisateurs-docker qui est créé lors de l'installation.   

Pour ajouter un utilisateur à ce groupe :

1. Ouvrir le Gestion informatique utilitaire. Vous pouvez le trouver en le recherchant dans le menu Démarrer. Il doit être exécuté en tant qu'administrateur.
2. Dans le volet de gauche, naviguez jusqu'à Local Users and Groups > Groups.
3. Localisez et cliquez avec le bouton droit de la souris sur l'icône utilisateurs-docker puis sélectionnez Add to Group….
4. Cliquez sur le bouton Add… tapez le nom du compte d'utilisateur auquel l'accès à Docker doit être accordé, et cliquez sur OK.
5. Après avoir ajouté l'utilisateur, il est essentiel de se déconnecter de Windows et se reconnecter. Cette étape est obligatoire pour que l'appartenance au nouveau groupe prenne effet ; un simple redémarrage n'est pas toujours suffisant.   

Décollage ! La vérification et votre premier conteneur du monde réel

Une fois l'installation et la configuration terminées, il est temps de vérifier l'installation et de lancer un conteneur. Cette section confirme que tous les composants fonctionnent correctement et fournit un résultat tangible.

La poignée de main de la ligne de commande

Ouvrez un nouveau terminal PowerShell ou Command Prompt. Si le compte d'utilisateur a été ajouté au utilisateurs-docker ce terminal devrait pas doit être exécuté en tant qu'administrateur, afin de vérifier que les autorisations fonctionnent correctement.

Tout d'abord, vérifiez que le CLI Docker peut communiquer avec le démon Docker en vérifiant la version :

Extrait de code

docker --version

Cela devrait renvoyer la version de Docker installée, par exemple, Docker version 25.0.3, build 4debf41.

Ensuite, exécutez la commande pour dresser la liste des conteneurs actifs :

Extrait de code

docker ps

Comme aucun conteneur n'est encore en cours d'exécution, cette commande devrait renvoyer un tableau vide avec seulement les en-têtes de colonne (CONTAINER ID, IMAGE, etc.). Cette réponse vide et réussie confirme que le CLI est correctement connecté au moteur Docker.   

The “Hello World” Ritual

La première étape traditionnelle dans le monde Docker est d'exécuter la commande bonjour-monde l'image. Cela permet de tester définitivement l'ensemble du système.

Extrait de code

docker run hello-world

Cette commande exécute plusieurs actions : elle vérifie la présence de l'élément bonjour-monde image locally, downloads it from the Docker Hub image repository if it’s not found, creates a new container from that image, runs the container, and prints a confirmation message to the terminal before exiting. A successful run will display a message beginning with “Hello from Docker!”   

Application pratique : Lancement d'un serveur web Nginx

Tandis que bonjour-monde confirms the system works, it doesn’t demonstrate practical usage. A far more engaging and instructive first step is to launch a live web server. This introduces core concepts like port mapping and detached mode, providing an interactive result that solidifies understanding. This approach bridges the gap from a simple installation check to genuine, practical application.   

Pour lancer un conteneur de serveur web Nginx, exécutez la commande suivante :

Extrait de code

docker run -d -p 8080:80 --name my-web-server nginx

Chaque partie de cette commande a une fonction spécifique :

• docker run: La commande principale pour créer et démarrer un nouveau conteneur.
• -d ou --détaché: Exécute le conteneur en arrière-plan, libérant ainsi le terminal pour d'autres commandes.
• -p 8080:80 ou --publier 8080:80: Maps port 8080 on the host machine (the PC) to port 80 inside the container. Nginx listens on port 80 by default, so this makes it accessible from the host’s browser.
• --name mon-serveur-web: Attribue un nom lisible par l'homme au conteneur pour en faciliter la gestion.
• nginx: Spécifie l'image officielle de Nginx à utiliser, que Docker tirera de Docker Hub.

Pour vérifier que le serveur web fonctionne, ouvrez un navigateur web et naviguez jusqu'à l'adresse http://localhost:8080. The “Welcome to nginx!” page should be displayed, confirming the container is running and accessible.

For an even more powerful demonstration, the default page can be customized using a bind mount. This links a directory on the host machine directly into the container’s filesystem.

1. Tout d'abord, arrêtez et retirez le conteneur existant : docker stop mon-serveur-web suivi de docker rm mon-serveur-web.
2. Créer un nouveau dossier sur le bureau nommé mon site.
3. Dans ce dossier, créez un nouveau fichier texte nommé index.html.
4. Ouvrir index.html et ajoutez le contenu suivant : <h1>Bonjour depuis mon premier conteneur Docker !</h1>.
5. Maintenant, lancez un nouveau conteneur avec un volume (-v) pour monter le répertoire local. Le chemin d'accès doit être un chemin absolu.docker run -d -p 8080:80 --name my-web-server -v C:\NUsers\NVotreNomDeDesktop\N-site:/usr/share/nginx/html nginx (Remplacer Votre nom d'utilisateur avec le nom d'utilisateur Windows actuel).
6. Actualiser le navigateur à http://localhost:8080. It will now display the custom “Hello from my first Docker container!” message. This demonstrates the power of bind mounts for live development.   

Votre boîte à outils essentielle pour les commandes Docker

Maintenant qu'un conteneur est en cours d'exécution, quelques commandes essentielles sont nécessaires pour le gérer. Cette section sert d'aide-mémoire pour les opérations Docker quotidiennes les plus courantes, permettant aux utilisateurs d'interagir immédiatement avec leur nouvel environnement conteneurisé et de le contrôler.   

Commandement	Description	Exemple d'utilisation
docker ps	Liste tous les conteneurs en cours d'exécution.	docker ps
docker ps -a	Liste tous les conteneurs, y compris ceux qui sont arrêtés.	docker ps -a
docker stop	Arrête un conteneur en cours d'exécution de manière élégante.	docker stop mon-serveur-web
docker start	Démarre un conteneur précédemment arrêté.	docker start mon-serveur-web
docker rm	Supprime un arrêté de façon permanente.	docker rm mon-serveur-web
images docker	Liste toutes les images Docker stockées localement sur la machine.	images docker
docker rmi	Supprime une image locale (uniquement si aucun conteneur ne l'utilise).	docker rmi nginx
docker logs	Récupère les journaux de sortie standard d'un conteneur.	docker logs mon-serveur-web
docker logs -f	Suit la sortie du journal en temps réel, en diffusant les nouveaux journaux.	docker logs -f mon-serveur-web
docker exec -it	Exécute une commande à l'intérieur d'un conteneur en cours d'exécution (par exemple, ouvre un shell).	docker exec -it mon-serveur-web bash
Tableau 2 : Liste des commandes Docker essentielles pour les débutants.

Dépannage : Votre guide des erreurs courantes d'installation et d'exécution

Même avec une préparation minutieuse, des problèmes peuvent survenir. Cette section sert de trousse de secours et traite des erreurs d'installation et d'exécution les plus courantes. Ces questions sont formulées de manière à correspondre aux messages d'erreur exacts que les utilisateurs sont susceptibles de rechercher, ce qui fait de ce guide une ressource précieuse pour le dépannage.

FAQ 1: Why am I getting an “Unexpected WSL error”?

• Symptômes : Docker Desktop ne démarre pas et affiche une fenêtre contextuelle avec cette erreur, mentionnant souvent des problèmes de droits d'accès ou suggérant un problème de sécurité. wsl --shutdown commande.   
• Solutions : Ces étapes doivent être effectuées dans l'ordre.
  1. Réinitialisation simple : Ouvrez PowerShell et exécutez wsl --shutdown. Cette commande arrête complètement la machine virtuelle WSL 2. Attendez quelques secondes, puis essayez de redémarrer Docker Desktop. Cela permet souvent de résoudre les problèmes d'état transitoires.   
  2. Réinitialisation de la pile réseau : Si le problème persiste, il peut être dû à une corruption de la pile réseau de Windows qui facilite la communication avec WSL. Ouvrez PowerShell en tant qu'administrateur et exécutez netsh winsock reset. Un redémarrage du système est nécessaire après cette commande.   
  3. Vérifier le type de lancement de l'hyperviseur : Assurez-vous que l'hyperviseur Windows est configuré pour démarrer automatiquement. Ouvrez un PowerShell administrateur et exécutez bcdedit /set hypervisorlaunchtype Autopuis redémarrer.   
  4. Cycle de réactivation complet : En dernier recours, les composants de virtualisation peuvent être entièrement réinstallés. Dans un PowerShell administrateur, exécutez les commandes suivantes pour désactiver les fonctionnalités : DISM /Online /disable-Feature /FeatureName:VirtualMachinePlatform DISM /Online /disable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux Redémarrez l'ordinateur. Ensuite, ouvrez un autre PowerShell administrateur et réactivez-les : DISM /Online /enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux DISM /Online /enable-Feature /FeatureName:VirtualMachinePlatform Redémarrez une dernière fois.   

FAQ 2: Docker Desktop won’t start after I close it or restart my PC. What’s wrong?

• Symptômes : L'application a fonctionné parfaitement après l'installation initiale, mais ne parvient plus à se lancer. L'icône Docker peut apparaître dans la barre d'état système puis disparaître, ou bien rien ne se passe du tout.
• Solution : Ce problème est souvent dû à des processus d'arrière-plan persistants qui ne se sont pas terminés correctement.
  1. Ouvrir Gestionnaire de tâches (Ctrl + Shift + Esc).
  2. Aller à la page Détails tabulation.
  3. Trier par nom et rechercher les processus nommés Docker Desktop.exe ou impliquant le backend Docker.
  4. Sélectionnez chacun de ces processus et cliquez sur Fin de la tâche.
  5. Une fois que tous les processus liés sont terminés, essayez de lancer à nouveau Docker Desktop.   

FAQ 3: The installer says “This app can’t run on your PC.” How do I fix it?

• Symptômes : Le Docker Desktop Installer.exe échoue immédiatement à l'exécution avec ce message d'erreur générique de Windows.
• Solution :
  1. Cause première : La raison la plus fréquente de cette erreur est une incompatibilité d'architecture. L'utilisateur a probablement téléchargé la version ARM64 pour un PC standard équipé d'un processeur Intel ou AMD. Retournez sur le site officiel de Docker et assurez-vous que l'option x86_64 / AMD64 est téléchargée.   
  2. Cause secondaire : Si le programme d'installation correct a été utilisé, cette erreur indique qu'une condition préalable du système central n'est pas remplie. Retournez à la section 1 de ce guide et vérifiez que la virtualisation du matériel est activée dans le BIOS/UEFI.

FAQ 4 : Mon installation a échoué en raison d'une erreur concernant la virtualisation ou le WSL.

• Symptômes : The installer shows an error message such as “WSL 2 installation is incomplete,” “Docker Desktop requires a WSL 2 backend,” or another message explicitly mentioning virtualization.
• Solution : Cela indique clairement qu'un prérequis a été omis ou qu'il n'est pas configuré correctement.
  1. Redémarrez et entrez dans le BIOS/UEFI pour confirmer que Intel VT-x ou AMD-V est Activé. Il s'agit du point de défaillance le plus courant.
  2. Ensure the “Virtual Machine Platform” Windows feature is turned on. To be certain, run dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dans un PowerShell administrateur et redémarrer.   

FAQ 5: I’m getting “permission denied” or “daemon is not running” errors when I run dockercommandes.

• Symptômes : Dans un terminal non-administrateur, des commandes telles que docker ps échouent avec une erreur indiquant que le client ne peut pas se connecter au démon Docker.
• Solution : Il s'agit d'un problème classique d'autorisations.
  1. Confirmez que le compte d'utilisateur actuel est membre du groupe d'utilisateurs utilisateurs-docker groupe local, comme indiqué à la section 3.
  2. L'essentiel est que l'utilisateur se déconnecter de Windows et se reconnecter pour que le changement d'appartenance à un groupe soit appliqué à leur jeton de sécurité. Le simple redémarrage ou la fermeture et la réouverture du terminal ne suffisent pas.

Conclusion : Votre voyage Docker commence maintenant

En suivant ce guide, un utilisateur a préparé avec succès son système Windows 11, installé les prérequis nécessaires comme WSL 2, installé et configuré Docker Desktop, vérifié l'installation complète et lancé un conteneur Nginx réel. Cette réalisation fournit une base puissante et stable pour le développement de logiciels modernes.

Avec un environnement Docker fonctionnel, le voyage vers la conteneurisation commence vraiment. Les prochaines étapes logiques pour développer cette base sont les suivantes :

• Apprendre Docker Compose : Pour les applications composées de plusieurs services (comme une application web, une base de données et une couche de mise en cache), Docker Compose est l'outil standard. Il permet de définir et de gérer une pile d'applications multi-conteneurs complète à l'aide d'un seul fichier de configuration YAML, simplifiant ainsi les déploiements complexes en une seule commande.   
• Écrire un fichier Docker : La véritable puissance de Docker se concrétise lors de l'empaquetage d'applications personnalisées. L'étape suivante consiste à apprendre à écrire un fichier Fichier Docker, which is a text file containing step-by-step instructions for building a custom Docker image from an application’s source code.   
• Explorer Docker Hub : Docker Hub est un vaste registre public contenant des milliers d'images préconstruites pour diverses applications et services. Il s'agit d'une ressource inestimable pour trouver des images officielles et d'une plateforme pour partager des images personnalisées avec la communauté ou une équipe privée.