Tutoriel 📝 Résoudre les problèmes d'installation ou de fonctionnement de WSL

[Sylvain*]

Résoudre les problèmes d'installation ou de fonctionnement de WSL

Introduction

Windows Subsystem for Linux (WSL) permet d’exécuter des distributions Linux directement sous Windows 10 et Windows 11. Cependant, il peut échouer à s’installer, à démarrer une distribution, ou afficher des erreurs comme "WslRegisterDistribution failed" ou "le noyau WSL n’est pas installé". Ce guide propose plusieurs solutions pour restaurer ou corriger le fonctionnement de WSL.

---

Prérequis

• Connaissance des environnements Linux et PowerShell

• Activation des fonctionnalités Windows

• Accès administrateur

---

Différentes Approches

• Approche #1 : Réinstaller les composants WSL avec CMD

• Approche #2 : Réinitialiser une distribution avec PowerShell

• Approche #3 : Installer manuellement le noyau WSL et les fonctionnalités manquantes

---

Niveau de difficulté

• Approche #1 : Facile

• Approche #2 : Moyen

• Approche #3 : Avancé

---

Les Avantages

• Approche #1 : Réinitialisation rapide de WSL

• Approche #2 : Restaure une distribution sans réinstaller WSL

• Approche #3 : Résout les erreurs liées au noyau et aux dépendances

---

Les Inconvénients

• Approche #1 : Nécessite une connexion internet

• Approche #2 : Perte de données de la distribution réinitialisée

• Approche #3 : Plus technique, nécessite plusieurs redémarrages

---

Approche #1

Ouvrir CMD en tant qu’administrateur

Réinstaller WSL avec la commande

wsl --install

Redémarrer le système une fois la commande exécutée

---

Approche #2

Ouvrir PowerShell en tant qu’administrateur

Réinitialiser une distribution spécifique (ex : Ubuntu)

wsl --unregister Ubuntu

Réinstaller la distribution via le Microsoft Store

---

Approche #3

Activer les fonctionnalités WSL manuellement

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Télécharger manuellement le noyau depuis :

Manual installation steps for older versions of WSL

Step by step instructions to manually install WSL on older versions of Windows, rather than using the wsl install command.

aka.ms

Installer le fichier téléchargé (.msi), redémarrer

Définir WSL 2 comme version par défaut

wsl --set-default-version 2

---

Astuce

Vérifiez la version actuelle de WSL avec la commande

wsl --list --verbose

pour identifier les distributions installées et leur version.

---

Mise en garde

Ne forcez pas l’installation de WSL sur des éditions non compatibles de Windows (ex. Windows 10 Home sans support Hyper-V).

---

Conseil

Gardez vos distributions WSL sauvegardées avec la commande

wsl --export <Distro> chemin\backup.tar

avant toute réinitialisation.

---

Solution alternative

• WSL Manager GUI gestion distributions Windows

• LxRunOffline outil gestion WSL Windows

• Pengwin distributions Linux pour WSL

---

Références

• Support Microsoft

• Microsoft Learn

• Recherche Github

---

Conclusion

Les problèmes avec WSL sont souvent liés à une configuration incomplète ou à une installation corrompue. Grâce à la réinstallation des composants, à l’activation manuelle des fonctionnalités requises et à l’utilisation de commandes avancées, il est possible de rétablir l’accès aux distributions Linux sous Windows. Une gestion proactive des versions et des sauvegardes de distributions garantit un environnement WSL stable et durable.