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. Cette technologie résout élégamment le problème classique et souvent frustrant du "ça marche sur ma machine" en garantissant qu'une application fonctionne de manière cohérente dans les environnements de développement, de test et de production. À 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.   

Les "5 minutes" mentionnées dans le titre se réfèrent spécifiquement au temps d'installation active et d'exécution des commandes que l'utilisateur passera. Il est important de fixer des attentes réalistes : les périodes d'attente passive pour le téléchargement de logiciels, le redémarrage du système et l'installation initiale et unique du sous-système Windows pour Linux (WSL) ne sont pas incluses dans cette estimation. 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 ?

Consacrer quelques minutes à cette liste de contrôle avant le vol est l'étape la plus importante pour garantir une installation rapide et sans heurts. Cette section est conçue pour traiter de manière proactive les points d'échec les plus courants, afin d'éviter de passer des heures à dépanner des messages d'erreur cryptiques par la suite. Un grand nombre d'échecs d'installation ne sont pas dus à Docker lui-même, mais à une cascade de mauvaises configurations du système sous-jacent. Par exemple, un paramètre de virtualisation désactivé dans le micrologiciel de l'ordinateur empêchera le Windows Subsystem for Linux (WSL 2) de fonctionner correctement. Cela entraînera à son tour l'échec de l'installation de Docker Desktop avec des erreurs vagues telles que "Unexpected WSL error" ou "This app can't run on your PC" (Cette application ne peut pas fonctionner sur votre 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 sur Windows n'exécute pas d'applications en mode natif ; il s'appuie sur la virtualisation du matériel pour exécuter un noyau Linux léger via WSL 2. Si cette fonctionnalité est désactivée dans le BIOS/UEFI du système, Docker Desktop ne peut pas fonctionner.   

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. Dans la section "Démarrage avancé", cliquez sur le bouton Redémarrer maintenant bouton.
3. L'ordinateur redémarre dans l'environnement de récupération Windows. À partir de là, sélectionnez Dépannage > Options avancées > Paramètres du micrologiciel UEFI 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.   

Une fois dans le menu BIOS/UEFI, le paramètre de virtualisation se trouve généralement sous un onglet "Avancé", "Configuration CPU" ou "Sécurité". L'option sera étiquetée comme 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.

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

Cette commande automatise plusieurs étapes qui devaient auparavant être effectuées manuellement. Elle active les fonctionnalités "Virtual Machine Platform" et "Windows Subsystem for Linux" nécessaires, télécharge le dernier noyau Linux de Microsoft, définit WSL 2 comme version par défaut et installe la distribution Ubuntu de Linux par défaut.   

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. Les forums de la communauté sont remplis de rapports d'utilisateurs qui ont rencontré une erreur immédiate "Cette application ne peut pas fonctionner sur votre PC" parce qu'ils ont accidentellement téléchargé le programme d'installation ARM64, qui est destiné à des appareils tels que la Surface Pro X. L'interface utilisateur de la page de téléchargement peut parfois être déroutante, il est donc essentiel de vérifier que la bonne version est téléchargée.   

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 "Utiliser WSL 2 au lieu d'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'à Utilisateurs et groupes locaux > Groupes.
3. Localisez et cliquez avec le bouton droit de la souris sur l'icône utilisateurs-docker puis sélectionnez Ajouter au groupe....
4. Cliquez sur le bouton Ajouter... 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.   

Le rituel du "Hello World

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 localement, la télécharge depuis le dépôt d'images de Docker Hub si elle n'est pas trouvée, crée un nouveau conteneur à partir de cette image, exécute le conteneur et affiche un message de confirmation dans le terminal avant de quitter. Une exécution réussie affichera un message commençant par "Hello from Docker !".   

Application pratique : Lancement d'un serveur web Nginx

Tandis que bonjour-monde confirme que le système fonctionne, mais ne démontre pas d'utilisation pratique. Une première étape beaucoup plus engageante et instructive consiste à lancer un serveur web réel. Cela permet d'introduire des concepts fondamentaux tels que le mappage des ports et le mode détaché, en fournissant un résultat interactif qui consolide la compréhension. Cette approche permet de passer d'une simple vérification de l'installation à une véritable application pratique.   

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: Le port 8080 de la machine hôte (le PC) est associé au port 80 à l'intérieur du conteneur. Nginx écoute sur le port 80 par défaut, ce qui le rend accessible depuis le navigateur de l'hôte.
• --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. La page "Welcome to nginx !" devrait s'afficher, confirmant que le conteneur fonctionne et est accessible.

Pour une démonstration encore plus puissante, la page par défaut peut être personnalisée à l'aide d'un montage bind. Ce montage relie un répertoire de la machine hôte directement au système de fichiers du conteneur.

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. Il affichera maintenant le message personnalisé "Hello from my first Docker container !". Ceci démontre la puissance des montages bind pour le développement en direct.   

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.   

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 : Pourquoi est-ce que je reçois le message "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 ne démarre pas après que je l'ai fermé ou que j'ai redémarré mon PC. Qu'est-ce qui ne va pas ?

• 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 : Le programme d'installation indique "Cette application ne peut pas fonctionner sur votre PC". Comment puis-je y remédier ?

• 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 : Le programme d'installation affiche un message d'erreur tel que "L'installation de WSL 2 est incomplète", "Docker Desktop nécessite un backend WSL 2", ou un autre message mentionnant explicitement la virtualisation.
• 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. Assurez-vous que la fonction Windows "Virtual Machine Platform" est activée. Pour vous en assurer, exécutez dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dans un PowerShell administrateur et redémarrer.   

FAQ 5 : J'obtiens des erreurs du type "permission denied" ou "daemon is not running" lorsque j'exécute le programme 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 Dockerqui est un fichier texte contenant des instructions étape par étape pour construire une image Docker personnalisée à partir du code source d'une application.   
• 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.