Vous ne parvenez plus à installer Ubuntu sous WSL sur Windows 11 ? Entre Microsoft Store capricieux, dépendances Hyper‑V/Virtual Machine Platform et fichiers système corrompus, voici un guide éprouvé pas à pas pour diagnostiquer et remettre WSL en état.
Vue d’ensemble de la situation
Plusieurs utilisateurs constatent soudainement l’impossibilité d’installer ou de réinstaller Ubuntu sous WSL (Windows Subsystem for Linux) : l’application n’apparaît plus comme installée, wsl --install échoue, le Microsoft Store renvoie des erreurs obscures, et la simple restauration d’un ancien ext4.vhdx ne remet pas le système en marche. Ce guide détaille une méthode fiable — testée — qui combine réparation de l’image Windows, contrôle des fonctionnalités de virtualisation et réinstallation propre de WSL et d’Ubuntu.
Symptômes fréquents et messages d’erreur
- Installation de la distribution qui reste bloquée sur « Acquisition … », « Téléchargement en attente … » ou échoue avec un code d’erreur.
wsl --installouwsl --install -d Ubunturenvoie une erreur immédiate ou ne télécharge rien.- L’image
ext4.vhdxcopiée dans un dossier WSL ne suffit pas à faire repartir la distribution.
Exemples d’erreurs courantes (non exhaustif) :
0x8007019e : The Windows Subsystem for Linux has not been enabled.
0x800701bc : WSL 2 requires an update to its kernel component.
0x80370102 : The Virtual Machine Platform is not enabled / problème de virtualisation.
0x80370114 : Operation could not be started because a required feature is not installed.
0x80070422 : Service désactivé (ex. Windows Update).
0x80072EE7 : Échec réseau/Store (DNS/TLS), Microsoft Store indisponible.
Pourquoi ces pannes se produisent
WSL 2 repose sur un noyau Linux léger qui s’exécute à l’aide des composants de virtualisation d’Hyper‑V. Trois briques doivent fonctionner de concert :
- Fonctionnalités Windows : Windows Subsystem for Linux et Virtual Machine Platform (Hyper‑V si disponible).
- Noyau WSL : mis à jour via
wsl --update(ou installé pendantwsl --install). - Distribution Linux : Ubuntu, téléchargée via le Microsoft Store ou via
wsl --install --web-download.
Des fichiers système Windows corrompus, un Microsoft Store instable, des pilotes obsolètes, ou une virtualisation désactivée (BIOS/UEFI ou composants Windows) suffisent à briser la chaîne.
Solutions proposées et validées
La séquence ci‑dessous a été utilisée avec succès pour rétablir l’installation d’Ubuntu sous WSL 2.
| Étape | Action | But / effet |
|---|---|---|
| 1 | Réparer l’image système Windows en Invite de commandes (admin) :DISM /Online /Cleanup-Image /ScanHealthDISM /Online /Cleanup-Image /CheckHealthDISM /Online /Cleanup-Image /RestoreHealth /Source:G:\Sources\install.wimSFC /ScannowAstuce : utilisez un ISO Windows 11 récent monté (ex. lecteur G:) pour garantir des sources saines. | Corrige les fichiers corrompus qui peuvent bloquer WSL et ses dépendances. |
| 2 | Suspendre temporairement Windows Update puis mettre à jour tous les pilotes (y compris chipset, GPU, réseau). Un utilitaire tiers peut aider (ex. un gestionnaire de pilotes réputé). | Évite que des mises à jour défectueuses ou des pilotes obsolètes n’interfèrent avec la virtualisation nécessaire à WSL 2. |
| 3 | Activer/contrôler les fonctionnalités Windows requises via « Activer ou désactiver des fonctionnalités Windows » : Windows Subsystem for Linux, Virtual Machine Platform, et Hyper‑V (si disponible). | Garantit que la virtualisation et WSL 2 sont bien actives. |
| 4 | Réinstaller WSL proprement :wsl --unregister <Distribution> (si elle apparaît)wsl --uninstall (réinitialisation WSL)wsl --install --web-download -d Ubuntu | Supprime les traces résiduelles et télécharge la dernière version de WSL/Ubuntu en contournant le Store grâce à --web-download. |
Procédure détaillée pas à pas
Préparer un support d’installation Windows propre
Montez un ISO Windows 11 récent (clic droit → Monter). Notez la lettre du lecteur (ex. G:). Cette source permet à DISM de remplacer des composants endommagés par des fichiers sains.
Exécutez en Invite de commandes (admin) :
DISM /Online /Cleanup-Image /ScanHealth
DISM /Online /Cleanup-Image /CheckHealth
DISM /Online /Cleanup-Image /RestoreHealth /Source:G:\Sources\install.wim
SFC /Scannow
Remarques utiles :
- Si DISM réclame un index, utilisez :
/Source:WIM:G:\sources\install.wim:1et, au besoin,/LimitAccess. - Après
SFC, redémarrez.
Mettre à jour les pilotes et stabiliser l’environnement
- Suspendre Windows Update quelques jours (Paramètres → Windows Update → Suspendre les mises à jour).
- Mettre à jour les pilotes chipset, graphique, réseau, stockage, et le firmware/BIOS si disponible.
- Redémarrer après mises à jour.
Vérifier la virtualisation matérielle
La virtualisation doit être activée dans l’UEFI/BIOS (Intel VT‑x ou AMD‑V). Sous Windows :
systeminfo | findstr /I "Virtualization"
Assurez‑vous que le hyperviseur démarre automatiquement :
bcdedit /enum {current} | findstr /I hypervisorlaunchtype
bcdedit /set hypervisorlaunchtype auto
Activer les fonctionnalités Windows requises
Ouvrez « Activer ou désactiver des fonctionnalités Windows » et cochez :
- Windows Subsystem for Linux
- Virtual Machine Platform
- Hyper‑V (si présent ; utile mais pas strictement obligatoire sur toutes les éditions)
Ou en commande :
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /all /norestart
Redémarrez ensuite.
Réinitialiser proprement WSL et installer Ubuntu
Exécutez en tant qu’administrateur :
wsl --shutdown
wsl --unregister Ubuntu # si la distribution existe encore dans la liste
wsl --uninstall # réinitialise WSL (supprime le composant si applicable)
wsl --install --web-download -d Ubuntu
Pourquoi --web-download ? Cette option télécharge WSL et la distribution sans passer par les bibliothèques du Store, très pratique si le Microsoft Store est instable.
Mettre WSL à jour et définir WSL 2 par défaut
wsl --update
wsl --set-default-version 2
wsl --status
Rappels et commandes utiles
- Vérifier la virtualisation matérielle dans le BIOS/UEFI (VT‑x/AMD‑V) : indispensable pour WSL 2.
- Mettre WSL à jour régulièrement :
wsl --update. - Afficher l’état :
wsl --status(version, kernel, etc.). - Réinitialiser WSL en cas de doute :
wsl --shutdown dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all - Importer une distro manuellement (depuis un rootfs .tar.gz) :
wsl --import Ubuntu C:\WSL\Ubuntu C:\Images\ubuntu-22.04.tar.gz --version 2
Vérifications rapides après chaque étape
| Commande | Résultat attendu | Interprétation si échec |
|---|---|---|
DISM /Online /Cleanup-Image /CheckHealth | Aucune corruption détectée | La source ISO est requise pour /RestoreHealth |
SFC /Scannow | « n’a détecté aucune violation d’intégrité » | Un redémarrage et un second SFC peuvent être nécessaires |
Get-Service LxssManager, vmcompute, hvhost | Services à l’état « Running » | Activer fonctionnalités, redémarrer, vérifier pilotes |
wsl --status | WSL 2 par défaut, noyau à jour | Lancer wsl --update, réactiver fonctionnalités |
systeminfo (virtualization) | Virtualization Enabled In Firmware: Yes | Activer VT‑x/AMD‑V dans l’UEFI/BIOS |
Contourner un Microsoft Store défaillant
Si le Store refuse d’installer Ubuntu (boucle « En attente », erreurs réseau), adoptez l’itinéraire hors Store :
wsl --install --web-download -d Ubuntu
Compléments utiles :
wsreset.exepour vider le cache du Store (exécuter, attendre l’ouverture du Store).- Vérifier la date/heure et TLS (certificats) si le Store renvoie des erreurs de connexion.
- Éviter les proxies ou VPN susceptibles de bloquer les flux du Store.
Réutiliser un ancien fichier ext4.vhdx
Copier un ext4.vhdx dans un dossier WSL ne suffit pas pour « réanimer » une distribution : WSL stocke aussi des métadonnées d’enregistrement. Méthodes recommandées :
- Export/Import officiels (idéal quand on a une sauvegarde conforme) :
wsl --export Ubuntu C:\Sauvegardes\ubuntu.tar wsl --import Ubuntu C:\WSL\Ubuntu C:\Sauvegardes\ubuntu.tar --version 2 - Si seul
ext4.vhdxest disponible : créez une nouvelle distro depuis un rootfs propre, puis restaurez les données (ex.rsync) à l’intérieur de la nouvelle instance. Remplacer directement leext4.vhdx« à chaud » est risqué et souvent infructueux.
Conseil : pensez à planifier des exports réguliers avec wsl --export pour des restaurations propres.
Dépannage avancé
Contrôler les fonctionnalités via DISM
dism /online /get-features /format:table | findstr /I "VirtualMachinePlatform Microsoft-Windows-Subsystem-Linux Microsoft-Hyper-V"
Services critiques
Ces services doivent démarrer correctement :
Get-Service LxssManager, vmcompute, HvHost | Format-Table Name, Status, StartType
Gestion de l’intégrité de la mémoire (HVCI)
Sur certains appareils, la Protection de l’intégrité de la mémoire (Core Isolation) peut empêcher la pile de virtualisation tierce d’opérer. Pour tester, vous pouvez la désactiver temporairement, redémarrer, valider que WSL fonctionne, puis la réactiver. Ne laissez pas cette protection désactivée de façon permanente.
Édition de Windows et Hyper‑V
WSL 2 fonctionne sur Windows 11 Home, mais l’option Hyper‑V complète peut ne pas être disponible. Virtual Machine Platform reste indispensable. Selon les appareils, activer Hyper‑V quand il est présent peut stabiliser le sous‑système.
Visionner les journaux
- Observateur d’événements → Journaux des applications et services → Microsoft → Windows → LxssManager
- Journaux Hyper‑V‑Hypervisor et Hyper‑V‑Compute pour des anomalies de démarrage de la VM WSL
Bonnes pratiques pour la pérennité
- Exporter vos distributions après une mise à jour majeure ou avant des changements système risqués.
- Éviter d’installer simultanément plusieurs solutions de virtualisation profondes (anciens VirtualBox, VMware Workstation non compatibles) susceptibles de monopoliser l’hyperviseur.
- Mettre à jour régulièrement le noyau WSL et vos distributions (
sudo apt update && sudo apt upgradecôté Ubuntu). - Surveiller l’espace disque de
C:\: une installation WSL/Ubuntu peut échouer si l’espace libre est faible.
FAQ rapide
Faut‑il Hyper‑V pour WSL 2 ? WSL 2 s’appuie sur des composants Hyper‑V, mais l’activation de la fonctionnalité Virtual Machine Platform est le prérequis clé. Si Hyper‑V est proposé sur votre édition, l’activer peut aider.
Le Microsoft Store est bloqué par la politique d’entreprise : puis‑je installer Ubuntu ? Oui, via wsl --install --web-download -d Ubuntu, sous réserve que la politique locale l’autorise.
Pourquoi ext4.vhdx ne suffit pas ? Parce que WSL enregistre la distribution et des méta‑informations hors de l’image. Utilisez wsl --export/wsl --import pour des migrations propres.
Résultat
En appliquant la séquence DISM + SFC avec un ISO Windows comme source, en suspendant temporairement Windows Update, en mettant à jour les pilotes et en réinstallant WSL avec --web-download, l’installation d’Ubuntu sous WSL a de nouveau fonctionné. Les vérifications (wsl --status, services, virtualisation BIOS) confirment un environnement stable et opérationnel.
Modèle de commandes récapitulatives
REM Réparer l’image Windows
DISM /Online /Cleanup-Image /ScanHealth
DISM /Online /Cleanup-Image /CheckHealth
DISM /Online /Cleanup-Image /RestoreHealth /Source:G:\Sources\install.wim
SFC /Scannow
REM Activer fonctionnalités
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /all /norestart
bcdedit /set hypervisorlaunchtype auto
REM Réinstaller WSL et Ubuntu
wsl --shutdown
wsl --unregister Ubuntu
wsl --uninstall
wsl --install --web-download -d Ubuntu
REM Vérifier et mettre à jour
wsl --set-default-version 2
wsl --update
wsl --status
Tableau de correspondance erreurs → correctifs
| Code | Signification probable | Action recommandée |
|---|---|---|
| 0x8007019e | WSL non activé | Activer la fonctionnalité WSL puis redémarrer |
| 0x800701bc | Noyau WSL non à jour | wsl --update puis relancer la distribution |
| 0x80370102 | Virtual Machine Platform/virtualisation manquante | Activer VMP et la virtualisation UEFI/BIOS, redémarrer |
| 0x80370114 | Fonctionnalité requise absente | Vérifier WSL/VMP/Hyper‑V, réparer avec DISM+SFC |
| 0x80070422 | Service désactivé (WU ou autre) | Réactiver, redémarrer, réessayer |
| 0x80072EE7 | Problème réseau/Store | wsreset.exe, vérifier DNS/TLS, utiliser --web-download |
Conclusion
La clé consiste à repartir d’une base Windows saine (DISM/SFC via ISO), à garantir la virtualisation (UEFI/BIOS + fonctionnalités Windows), puis à réinstaller WSL et Ubuntu en contournant les fragilités du Store si nécessaire. Cette approche méthodique corrige la majorité des blocages d’installation d’Ubuntu sous WSL 2 sur Windows 11.

