Vous voulez WSL, le Sous-système Windows pour Linux, mais pas Ubuntu. Vous ouvrez donc le Terminal en administrateur et vous tapez la commande prévue pour cela, wsl --install --no-distribution. Windows répond aussitôt :
Vous ajoutez --web-download. Même réponse. Et la commande conseillée par le message, c'est justement celle qui risque d'installer Ubuntu.
WSL s'installe très bien sans cette commande. Sur un PC fixe neuf sous Windows 11 Pro que nous avons traité en novembre 2026, winget et dism ont fait le travail en trois commandes et un redémarrage, sans aucune distribution Linux. Voici la méthode, ce qu'il faut vérifier avant, et quoi faire si une étape coince.
| Situation | Ce qu'il faut faire |
|---|---|
wsl --install --no-distribution ne fait rien | Passer par winget install Microsoft.WSL, puis les deux commandes dism, puis redémarrer |
| Vous ne voulez pas d'Ubuntu | Ne lancez pas wsl --install seul : cette commande installe Ubuntu par défaut |
wsl --list dit qu'aucune distribution n'est installée | C'est le résultat attendu, pas une panne |
Erreur 0x80370102 plus tard | Virtualisation à vérifier dans le BIOS, voir la section 5 |
| Windows 11 Famille | La méthode s'applique aussi : WSL 2 n'y demande pas Hyper-V complet |
Le message est trompeur, parce que la commande wsl existe bel et bien. Sur un Windows neuf, le fichier wsl.exe du dossier C:\Windows\System32 n'est pourtant qu'une petite porte d'entrée. Pensez à un interphone : il répond quand on sonne, mais l'appartement est vide.
Le vrai WSL est un logiciel à part, qui s'installe dans C:\Program Files\WSL. Il évolue indépendamment de Windows. Les deux portent d'ailleurs des numéros sans rapport : sur notre poste, 10.0.26100.x pour l'interphone, 2.7.14.0 pour le logiciel.
Il faut en réalité trois pièces pour que WSL 2 fonctionne :
| Pièce | Son rôle | Avec quoi on l'installe |
|---|---|---|
| Le paquet WSL | Le logiciel lui-même | winget |
| Plateforme de machine virtuelle | La fonctionnalité Windows qui fait tourner la petite machine virtuelle de WSL 2 | dism |
| Sous-système Windows pour Linux | La fonctionnalité Windows historique de WSL | dism |
D'après l'aide de WSL, --no-distribution doit installer les composants requis sans distribution. Sur notre poste, elle a rendu le code d'erreur 1 sans rien installer, et les deux fonctionnalités sont restées désactivées.
Nous n'avons pas établi pourquoi. En revanche, nous avons écarté les suspects habituels : la session était administrateur, la virtualisation était active et aucune politique ne bloquait WSL. Microsoft présente cette option comme normale, et elle peut très bien marcher chez vous. Si elle échoue, inutile d'y passer la soirée : on pose les trois pièces à la main.
Ouvrez un terminal administrateur. Faites un clic droit sur le bouton Démarrer, puis Terminal (administrateur). Toutes les commandes de cet article se tapent dans cette fenêtre.
Vérifiez que WSL est vraiment absent. Tapez wsl --version. Si des numéros s'affichent, à commencer par une ligne Version WSL, le paquet est déjà là. Passez alors directement aux commandes dism de la section 3.
Vérifiez la virtualisation. Ouvrez le Gestionnaire des tâches, onglet Performance, puis Processeur. La ligne Virtualisation doit indiquer Activé. Si elle indique Désactivé, l'installation passera, mais WSL 2 ne pourra pas démarrer de distribution. Il faudra régler ce point à la section 5. Vous pouvez le faire après.
Première étape : installer le paquet WSL.
winget install Microsoft.WSL
Si winget vous demande d'accepter les conditions d'utilisation de ses sources, répondez oui. Il télécharge le paquet et l'installe. Dans notre cas, il a posé la version 2.7.14.0 : la vôtre peut être plus récente.
Deuxième étape : activer le Sous-système Windows pour Linux.
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Troisième étape : activer la Plateforme de machine virtuelle.
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Ce sont les deux commandes de la procédure manuelle de Microsoft. L'option /norestart évite que Windows redémarre entre les deux.
Pour les curieux : dans notre cas, chacune a rendu le code 3010 (on le lit en tapant $LASTEXITCODE dans PowerShell). Ce n'est pas une erreur. Cela veut dire « terminé, un redémarrage est nécessaire ».
Quatrième étape : redémarrer. Enregistrez votre travail, puis menu Démarrer, bouton Marche/Arrêt, Redémarrer. Sans ce redémarrage, les fonctionnalités ne sont pas actives.
Après le redémarrage, ouvrez un terminal et tapez ces trois commandes, l'une après l'autre.
| Commande | Ce que vous devez voir |
|---|---|
wsl --version | Une liste de versions, dont Version WSL |
wsl --status | Version par défaut : 2 |
wsl --list | Un message indiquant qu'aucune distribution n'est installée |
Ce dernier message inquiète souvent, alors qu'il est la preuve que tout s'est passé comme prévu : WSL fonctionne et il est vide. C'est exactement ce que vous vouliez.
« winget n'est pas reconnu ». Sur un Windows tout juste installé, l'outil n'est disponible qu'après la première ouverture de session, et son inscription peut prendre du temps. Microsoft donne cette commande pour la demander :
Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe
Autre voie : téléchargez le fichier .x64.msi sur la page officielle des versions de WSL et lancez-le. C'est le même programme que celui installé par winget. Passez ensuite aux commandes dism.
Erreur 0x80370102 au lancement d'une distribution. Le message parle d'une fonctionnalité requise qui n'est pas installée. Dans l'ordre :
bcdedit /enum | findstr -i hypervisorlaunchtype. S'il est sur Off, tapez bcdedit /set hypervisorlaunchtype Auto, puis redémarrez.La virtualisation marchait et a disparu d'un coup ? Pensez à une mise à jour ou une remise à zéro du BIOS : ce réglage peut repartir sur sa valeur d'usine.
Erreur 0x8007019e. Le Sous-système Windows pour Linux n'est pas activé. Reprenez la deuxième étape, puis redémarrez.
Erreur 0x800704ec (bloqué par une stratégie de groupe). Tapez wsl --update. Si le blocage persiste sur un PC d'entreprise, seul l'administrateur de votre parc peut le lever.
Erreur 0x80070003. WSL doit rester sur le disque système. Dans Paramètres, Système, Stockage, ouvrez les paramètres de stockage avancés, puis le réglage de l'emplacement du nouveau contenu, et remettez les nouvelles applications sur C:.
VMware ou VirtualBox est installé. Mettez-le à jour, ou arrêtez-le. Microsoft indique que VMware fonctionne avec WSL 2 à partir de la version 15.5.5, et reste plus réservé pour VirtualBox.
Vous êtes dans une machine virtuelle. WSL 2 y demande la virtualisation imbriquée, à activer sur la machine hôte. Dans Hyper-V, c'est la commande Set-VMProcessor -VMName <nom> -ExposeVirtualizationExtensions $true.
Le processeur est très ancien. WSL 2 exige une fonction processeur appelée SLAT. Microsoft cite les Intel Core de première génération comme point de départ, et le Core 2 Duo comme exemple de processeur exclu. Un tel PC ne fait pas tourner Windows 11 sans le forcer sur une machine non compatible, et aucune commande ne contournera cette limite.
DISM s'arrête sur 0x80070570 ou une erreur 1392. Là, ce n'est plus une affaire de WSL : DISM signale un fichier corrompu. Le réflexe est de regarder le disque avant de chercher une réparation. Sur un PC traité à l'atelier, cette même erreur venait d'un SSD instable et d'une table de fichiers abîmée. Copiez vos données importantes tant qu'elles sont lisibles et ne lancez aucune réparation du disque. Si des fichiers sont déjà illisibles, ou si un disque dur fait des bruits anormaux, c'est le métier de BSC DataRecovery, notre laboratoire de récupération de données.
Ne lancez pas wsl --install seul si vous ne voulez pas de distribution. C'est le geste que le message d'erreur vous suggère. Or Microsoft le dit clairement : cette commande active ce qu'il faut pour WSL et installe Ubuntu. Elle peut sembler anodine, mais vous vous retrouvez avec ce que vous cherchiez à éviter, et un compte Linux à créer au premier lancement.
N'utilisez pas wsl --unregister pour « faire le ménage ». Si le PC a déjà une distribution, cette commande la retire et efface toutes ses données, définitivement. Sauvegardez-la d'abord avec wsl --export.
N'installez pas Hyper-V complet par réflexe. WSL 2 n'en a pas besoin. Il s'appuie sur la Plateforme de machine virtuelle, un sous-ensemble disponible sur toutes les éditions de bureau, Famille comprise.
Ne réinstallez pas Windows pour ça. Un Windows sain n'a pas à être refait pour une fonction facultative qui ne s'installe pas. Si vous en arrivez là pour d'autres raisons, lisez d'abord comment réinstaller Windows sans perdre ses données.
Un WSL vide a son utilité. Il accueille un outil qui apporte sa propre distribution, comme Docker Desktop, ou une distribution que vous importez vous-même avec wsl --import.
Si vous voulez ajouter une distribution classique, vous choisissez laquelle :
wsl --list --online wsl --install -d Debian
La première commande donne la liste des noms disponibles, la seconde installe celle que vous avez choisie. Maintenant que le vrai WSL est en place, la commande wsl --install reprend son rôle normal.
Une question avant de vous lancer ? Écrivez-nous, avec le message exact et le résultat de wsl --version.
Essayez d'abord wsl --install --no-distribution dans un terminal administrateur. Si WSL reste « non installé », utilisez winget install Microsoft.WSL, puis les deux commandes dism, puis redémarrez.
wsl --install --no-distribution ne fait rien ?Sur le poste que nous avons traité, la commande a rendu le code 1 sans rien installer. La cause exacte n'a pas été établie. Droits administrateur, virtualisation et politiques de sécurité ont été écartés.
Oui, il est installé et prêt, mais il n'a rien à lancer tant que vous n'ajoutez pas une distribution. wsl --list vous l'indique, et c'est normal.
Oui. WSL 2 est disponible sur Windows 11 Famille, avec la même méthode.
Tapez wsl --update dans un terminal. Vérifiez ensuite le numéro avec wsl --version.
--web-download règle-t-il le problème ?Pas dans notre cas : la commande a échoué de la même façon, avec ou sans cette option.
BSC Informatique, EURL BSC INFORMATIQUE, 18 Avenue Olbius Riquier, 83400 Hyères, 04 94 27 65 95.
Windows, virtualisation et postes de travail,
pour les particuliers et les professionnels.