Installer Docker Desktop sous Windows avec le moteur WSL 2

Sous Windows, Docker passe par Docker Desktop, qui fait tourner le moteur Docker dans WSL 2. L'installation tient en un installateur, mais les prérequis et la licence méritent d'être lus avant.

Par la rédaction de Pixelabs · 12 octobre 2026

Docker Desktop fournit le moteur Docker, la ligne de commande docker et une interface graphique, et s'appuie sur l'une des trois couches de virtualisation (backends) que liste la documentation Docker : WSL 2 (par défaut), Hyper-V ou Docker VMM (en bêta). WSL 2, le sous-système Windows pour Linux, convient à la plupart des usages et ne demande pas de droits d'administrateur en installation par utilisateur.

Windows 10 : la question à régler d'abord

Cette page portait à l'origine sur Windows 10. Microsoft a mis fin au support de Windows 10 le 14 octobre 2025 ; la version 22H2 en était la dernière. Or Docker précise qu'il ne prend en charge Docker Desktop que sur les versions de Windows encore couvertes par le calendrier de maintenance de Microsoft. La configuration requise publiée par Docker mentionne toujours Windows 10 22H2, mais un poste Windows 10 sorti du support n'est plus une base durable : visez Windows 11.

Avant d'installer quoi que ce soit sur un poste de travail utilisé au quotidien, essayez la procédure sur une machine de test et sauvegardez vos données : l'activation de WSL 2 et de la virtualisation touche à la configuration du système.

Configuration requise selon Docker

Voici les exigences du moteur WSL 2 sur x86_64, telles que la documentation Docker les publie :

Deux limites à connaître. Docker Desktop n'est pas pris en charge sur les versions serveur de Windows, comme Windows Server 2019 ou 2022 : pour des conteneurs sur un serveur, Docker renvoie à la documentation de Microsoft. Et les conteneurs Windows exigent une édition Professionnelle ou Entreprise ; les éditions Famille et Éducation ne font tourner que des conteneurs Linux.

Le poste de cet exemple

Étape 1 : installer ou mettre à jour WSL

Vérifiez d'abord la version de WSL dans un terminal :

wsl --version

Si aucune version ne s'affiche, Docker indique qu'il s'agit probablement de l'ancienne version intégrée de WSL, à mettre à jour. Dans PowerShell ouvert en administrateur, lancez l'une des commandes suivantes, puis redémarrez si Windows le demande :

wsl --install
wsl --update

Selon Microsoft, wsl --install installe tout le nécessaire et crée une distribution Ubuntu par défaut ; les nouvelles distributions sont réglées sur WSL 2. Si le Microsoft Store est bloqué par une stratégie de sécurité, Docker renvoie au paquet MSI publié sur la page des versions de WSL.

Étape 2 : installer Docker Desktop

Téléchargez Docker Desktop Installer.exe depuis la documentation Docker, puis lancez-le. L'installateur demande le mode d'installation :

Sur la page Configuration, cochez l'option qui utilise WSL 2 au lieu d'Hyper-V. Changer de mode d'installation plus tard impose de désinstaller puis réinstaller.

Pour un déploiement scripté, la documentation donne la forme PowerShell suivante, pour une installation par utilisateur :

Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--user'

L'option --backend=wsl-2 fixe explicitement le moteur par défaut, et --accept-license accepte les conditions d'abonnement dès l'installation.

En installation pour tous les utilisateurs, l'appartenance au groupe docker-users donne accès au socket du démon Docker, ce que Docker qualifie d'équivalent à des droits d'administrateur sur l'hôte. N'y ajoutez que les comptes qui en ont besoin ; pour des conteneurs Linux avec WSL 2, ce n'est pas nécessaire.

Étape 3 : premier démarrage et licence

Docker Desktop ne démarre pas tout seul après l'installation : cherchez « Docker Desktop » dans le menu Démarrer. Au premier lancement, il affiche le Docker Subscription Service Agreement, sans l'acceptation duquel il ne fonctionne pas. Selon la documentation Docker, l'usage est gratuit pour les petites entreprises (moins de 250 salariés et moins de 10 millions de dollars de chiffre d'affaires annuel), l'usage personnel, l'enseignement et les projets open source non commerciaux ; les autres usages professionnels, comme les administrations, exigent un abonnement payant. Lisez ces conditions sur la page de Docker avant un déploiement en entreprise, elles peuvent évoluer.

Dans Settings > General, vérifiez que Use WSL 2 based engine est actif (l'option est cochée et masquée par défaut sur un système compatible). Pour utiliser docker depuis votre distribution Ubuntu, activez-la dans Settings > Resources > WSL Integration.

Vérifier l'installation

Dans PowerShell, contrôlez que la distribution tourne bien en WSL 2 :

wsl.exe -l -v
docker version
docker run hello-world

docker version doit afficher une partie client et une partie serveur ; sans partie serveur, le moteur ne répond pas. L'image hello-world est celle que la documentation Docker utilise pour valider une installation : elle se télécharge, affiche un message de confirmation et s'arrête.

Les erreurs les plus fréquentes

Conteneurs, VM et serveurs

Docker Desktop est un outil de poste de travail. Pour héberger des conteneurs LXC et des VM sur un serveur, voyez l'installation de Proxmox VE ; pour un serveur Windows de test, montez plutôt une VM Windows Server dans VirtualBox. Si vous cherchez des images d'applications prêtes à l'emploi, la page sur le catalogue Bitnami fait le point sur leur distribution actuelle. Le reste des guides est dans la rubrique machines virtuelles et conteneurs et sur l'accueil des tutoriels Linux et Windows.

Questions fréquentes