Installez Docker sur Windows avec WSL 2 et exécutez votre premier conteneur
Docker sous Windows fonctionne mieux sur un vrai noyau Linux, et WSL 2 vous offre exactement cela. Ce guide installe les éléments dans l'ordre qui évite les erreurs classiques : WSL 2 en premier, Docker Desktop en second et un petit conteneur de test pour prouver que toute la chaîne fonctionne.
✍️ Technical Anshu🪟 Windows 10 / 11⏱️ 10 minute setup and read
🎥 Regardez l'installation complète dans la vidéo - Configuration de WSL 2 et du premier conteneur, étape par étape
La plupart des installations Docker ayant échoué sur Windows échouent pour une raison ennuyeuse : l'ordre était erroné. Docker Desktop s'attend à un WSL 2 fonctionnel en dessous, nous construisons donc d'abord la fondation, la vérifions, puis installons Docker seulement. À la fin, vous exécuterez hello-world - un petit conteneur qui prouve que le client, le moteur, le réseau et le magasin d'images fonctionnent tous. Suivez la vidéo ci-dessus pour la procédure pas à pas à l'écran ; cette page est la liste de contrôle écrite avec les avertissements honnêtes inclus.
Windows PowerShell - the two commands that prove the install (real output style)
PS C:\Users\Anshu> docker --version
Docker version 27.x, build xxxxxxx
PS C:\Users\Anshu> docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
Hello from Docker!
This message shows that your installation appears
to be working correctly.
À quoi ressemble réellement le succès : la ligne de version, le premier pull et le propre message de confirmation de Docker
1
Vérifiez d'abord que votre PC peut le faire
Docker Desktop avec le backend WSL 2 a besoin de trois choses. Sauter ce contrôle est la façon dont les gens perdent une soirée.
Windows 10 version 2004 ou ultérieure, ou Windows 11 - vérifiez auprès de winver
Virtualisation activée dans le BIOS ou l'UEFI : ouvrez le Gestionnaire des tâches, accédez à Performances, puis CPU, et recherchez Virtualisation : Activée. S'il est indiqué Désactivé, aucun paramètre logiciel ne vous sauvera ; activez d'abord Intel VT-x ou AMD SVM dans le BIOS
Environ 4 Go de RAM libre et quelques Go de disque - WSL 2 et Docker partagent votre machine, ils ne la remplacent pas
Remarque honnête : sur les éditions Windows Home, cette route WSL 2 n'est pas une solution de contournement, c'est la route prévue. Hyper-V n'est pas requis pour cela.
2
Installez WSL 2 avant toute chose
Ouvrez PowerShell en tant qu'administrateur et exécutez une commande :
wsl --install
Laissez terminer, puis redémarrez le PC - cette étape n'est pas facultative, le redémarrage charge les composants de virtualisation
Après le redémarrage, Ubuntu (la distribution par défaut) termine sa propre configuration et vous demande de créer un nom d'utilisateur et un mot de passe Linux. Ce mot de passe est uniquement destiné à Linux sudo - choisissez-en un dont vous vous souviendrez, car rien ne s'affiche à l'écran lorsque vous le tapez.
Confirmez la fondation avec wsl --status et wsl -l -v - votre distribution devrait afficher la VERSION 2. S'il affiche 1, exécutez wsl --set-default-version 2 et convertissez la distribution comme le suggère le résultat de la commande.
Il y a une page complète dans cet ensemble expliquant pourquoi cet ordre est important et ce qui se casse lorsque Docker entre en premier.
3
Installer Docker Desktop sur le dessus
Téléchargez Docker Desktop uniquement depuis docker.com : les sites de téléchargement tiers regroupent les fichiers indésirables avec les installateurs populaires
Exécutez le programme d'installation et laissez l'option Utiliser WSL 2 au lieu d'Hyper-V cochée - sur la plupart des PC, elle est cochée par défaut
Lorsque le programme d'installation vous le demande, laissez-le se fermer et déconnectez-vous ou redémarrez si vous y êtes invité. Docker ajoute votre compte Windows au groupe local docker-users et l'adhésion au groupe ne prend effet que lors d'une nouvelle connexion.
Démarrez Docker Desktop et attendez que l'icône de baleine dans la barre d'état système se stabilise et que le tableau de bord signale Moteur en cours d'exécution. Le premier démarrage est lent ; donne-lui quelques minutes
Acceptez honnêtement l'écran du contrat de service d'abonnement Docker : il s'agit d'une véritable licence, et la page de licence de cet ensemble explique quand Docker Desktop est gratuit et quand une entreprise doit payer
4
Prouvez-le avec Hello World
Ouvrez une nouvelle fenêtre PowerShell ou Terminal et exécutez :
docker --version - prouve que le client est installé et sur votre PATH
docker run hello-world - prouve tout le reste. Docker ne peut pas trouver l'image localement, la télécharge depuis Docker Hub, crée un conteneur à partir de celle-ci, l'exécute et imprime son message
Si le message apparaît, votre chaîne fonctionne de bout en bout : terminal, client, moteur dans WSL 2, réseau et registre.
Note honnête : la première exécution nécessite Internet pour être tirée. En cas d'échec, ne réinstallez pas aveuglément - la page du ladder qui ne démarre pas dans cet ensemble examine les causes dans l'ordre.
5
Deux avertissements honnêtes avant d'aller plus loin
Les utilisateurs Docker signifient le pouvoir. N'importe qui dans ce groupe peut exécuter des conteneurs, et un conteneur peut monter l'intégralité du lecteur Windows - traitez l'adhésion des utilisateurs Docker comme une confiance de niveau administrateur et ajoutez uniquement les comptes auxquels vous confierez la machine.
Conservez les fichiers de projet sous Linux. Le code stocké dans le système de fichiers WSL (votre dossier personnel Ubuntu) est considérablement plus rapide pour les conteneurs que les mêmes fichiers accessibles via /mnt/c. Déplacez les projets actifs vers Linux et ouvrez-les à partir de là.
🔴 Docker Desktop est gratuit pour un usage personnel et pour les petites entreprises sous les seuils de taille publiés par Docker - et un abonnement payant par utilisateur pour les grandes entreprises. Si vous l'installez sur un ordinateur de bureau, lisez la page de licence de cet ensemble avant que votre équipe informatique ou d'audit ne pose la question en premier.
🎥 Regardez le processus complet dans la vidéo
Voir la configuration complète dans la vidéo : installation de WSL 2, installation de Docker Desktop et premier conteneur exécuté en direct.
Pour un usage personnel, l'éducation et les petites entreprises sous les seuils d'employés et de revenus publiés par Docker, oui, Docker Desktop est gratuit. Les grandes entreprises ont besoin d'un abonnement payant par utilisateur. Docker Engine sur un serveur Linux est une route distincte et open source et est couverte dans la page de licence de cet ensemble.
Ai-je besoin de Windows 11 Professionnel ou Hyper-V pour Docker avec WSL 2 ?
Non. Le backend WSL 2 fonctionne également sur Windows 10 Famille et Windows 11 Famille. Vous avez besoin de la virtualisation activée dans le BIOS et d'une version Windows suffisamment récente. Hyper-V n'est nécessaire que pour l'ancien backend Hyper-V, que ce guide n'utilise pas.
Docker Desktop est bloqué au démarrage. Que dois-je vérifier en premier ?
Vérifiez dans cet ordre : la virtualisation affiche Activé dans le Gestionnaire des tâches, wsl --status s'exécute proprement et votre distribution est la version 2, le Docker Desktop Service s'exécute dans services.msc, et vous vous êtes déconnecté et reconnecté depuis l'installation, donc le groupe d'utilisateurs Docker s'applique. La page de l'échelle de correction de cet ensemble passe par chaque étape.
Ce guide est basé sur la vidéo Technical Anshu Docker sur WSL 2. • Vous êtes bloqué sur une étape ? Demandez dans les commentaires de la vidéo — vous y recevrez une réponse 🙏