Si vous utilisez WSL sous Windows, vous avez probablement rencontré quelques difficultés pour tout configurer correctement. La configuration matérielle varie d’un ordinateur à l’autre, et parfois, même avec les bonnes commandes, rien ne fonctionne. Il se peut que les distributions Linux ne soient pas détectées, ou que WSL refuse tout simplement de s’installer. Ou encore, l’environnement ne se comporte peut-être pas comme prévu — cela vous dit quelque chose ? Ce guide a pour but de vous aider à résoudre ces problèmes en présentant des méthodes courantes de dépannage et d’installation manuelle de WSL2 si l’installation automatique ne fonctionne pas.
Configurer et faire fonctionner WSL correctement peut faire toute la différence, que ce soit pour le développement, le scripting ou simplement pour bénéficier d’un environnement Linux complet sous Windows. Cependant, la configuration matérielle et logicielle étant variable, le processus n’est pas toujours aussi simple qu’un clic. Dans ce cas, connaître les commandes et les chemins d’accès précis peut vous faire gagner un temps précieux. Il vous faudra probablement modifier les paramètres du BIOS, activer manuellement certaines fonctionnalités et télécharger la mise à jour du noyau, surtout si la méthode en une seule commande ne fonctionne pas comme prévu.
Comment résoudre les problèmes d’installation et de configuration de WSL sous Windows
Méthode 1 : Activation manuelle des fonctionnalités WSL et de la plateforme de machine virtuelle
Tout d’abord, si la commande « wsl –install » n’a pas fonctionné, c’est souvent parce qu’une fonctionnalité Windows requise n’est pas activée. Malheureusement, Windows doit prendre en charge une partie du travail. Cette procédure est également utile en cas d’erreurs telles que 0x80070003 ou 0x80370102, qui indiquent généralement que la virtualisation n’est pas activée dans votre BIOS.
- Ouvrez PowerShell en tant qu’administrateur (cliquez avec le bouton droit sur le menu Démarrer et choisissez Windows PowerShell (Admin)).
- Exécutez les commandes suivantes pour activer les fonctionnalités nécessaires :
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
Ces commandes activent WSL et la prise en charge de la virtualisation, ce qui est plutôt étrange car ce n’est pas activé par défaut. Après les avoir exécutées, redémarrez votre PC — c’est indispensable. Sinon, tout restera désactivé et vous serez de nouveau bloqué.
Méthode 2 : Installation manuelle du noyau WSL2
Il arrive que la mise à jour automatique du noyau échoue ou que votre système ne parvienne pas à la télécharger correctement. Pour vous simplifier la vie, téléchargez manuellement le paquet de mise à jour du noyau Linux WSL2. Il s’agit d’un petit fichier MSI qui effectue les mises à jour en arrière-plan.
- Téléchargez la mise à jour du noyau directement depuis le [lien officiel Microsoft](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi).Vous pouvez le faire via votre navigateur ou PowerShell :
Invoke-WebRequest -Uri https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi -OutFile "$($env:userprofile)\Downloads\wsl_update_x64.msi" -UseBasicParsing Invoke-Item "$($env:userprofile)\Downloads\wsl_update_x64.msi" rm "$($env:userprofile)\Downloads\wsl_update_x64.msi"
Après avoir exécuté cette commande, redémarrez votre machine. Une fois redémarrée, définissez WSL 2 comme version par défaut :
wsl --set-default-version 2Cette commande garantit que les nouvelles installations utilisent WSL2 et non l’ancienne version WSL1. Car, bien sûr, Windows se doit de compliquer les choses inutilement.
Méthode 3 : Vérification de la prise en charge de la virtualisation par le BIOS
Si vous rencontrez des erreurs lors de l’installation, comme « erreur 0x80070003 » ou un message indiquant que la virtualisation n’est pas activée, le problème est probablement lié au BIOS. Redémarrez votre PC et accédez aux paramètres du BIOS/UEFI (généralement en appuyant sur les touches F1 F2, DelF2 ou EscF3 au démarrage).Recherchez ensuite une option comme Intel VT-x ou AMD-V et assurez-vous qu’elle est activée. Si elle est désactivée, activez-la, enregistrez vos modifications et redémarrez. Windows ne peut évidemment pas activer cette fonctionnalité automatiquement.
Méthode 4 : Vérifier que la version de WSL et les distributions sont correctement installées
Une fois tout installé, vérifiez que WSL est bien configuré en version 2 et que vos distributions sont prêtes à l’emploi :
wsl --list --verboseSi votre distribution apparaît mais n’utilise pas la version 2, exécutez simplement :
wsl --set-version 2 Cela vous garantit une prise en charge complète du noyau Linux. N’oubliez pas de remplacer <distribution_name> par le nom réel de votre distribution, comme Ubuntu ou Kali Linux.
Méthode 5 : Installation manuelle des distributions sans passer par le Microsoft Store
Si le Microsoft Store est désactivé, ou si vous utilisez un serveur Windows ou une machine isolée du réseau, vous pouvez télécharger manuellement les distributions sous forme de fichiers APPX et les installer à l’aide de PowerShell :
Invoke-WebRequest https://aka.ms/wslubuntu2204 -OutFile ubuntu-2204.appx –UseBasicParsing Add-AppxPackage.\ubuntu-2204.appxC’est une méthode un peu plus avancée, mais elle vous épargne bien des tracas si tout le reste échoue.
Conseils supplémentaires : Gestion des configurations et des ressources WSL
Pour ajuster la quantité de processeur ou de RAM allouée à votre environnement Linux, créez un fichier de configuration comme %UserProfile%\.wslconfigcelui-ci :
[wsl2] memory=4GB processors=2 Ainsi, WSL n’accaparera pas toutes vos ressources, surtout si vous gérez des charges de travail importantes.
Après avoir installé une distribution, n’oubliez pas de mettre à jour vos paquets Linux et d’installer de nouveaux logiciels, comme sur n’importe quelle machine Linux. Exécutez une commande similaire $ sudo apt-get update && sudo apt-get upgrade -ydans votre shell WSL. C’est une bonne pratique pour maintenir un système propre et sécurisé.
Enfin, si vous explorez des fichiers ou tentez d’y accéder depuis Windows, vous pouvez facilement naviguer jusqu’à \\wsl$ dans l’Explorateur de fichiers ou utiliser des chemins UNC notepad \\wsl$\Ubuntu\sysops\home\mytext.txt. C’est simple et rapide une fois qu’on a pris le coup de main.
Et si vous souhaitez exécuter des applications Linux avec interface graphique, comme GIMP, il suffit de l’installer $ sudo apt install gimp -yet de la lancer depuis l’invite de commandes WSL. WSL 2 prend désormais en charge les applications avec interface graphique, ce qui est plutôt génial ; cependant, ne me demandez pas pourquoi il faut parfois s’y reprendre à plusieurs fois pour que cela fonctionne sans problème.
Ces conseils devraient vous faire gagner du temps si WSL fait des siennes. Ils ne sont pas infaillibles, mais ils suffisent généralement à résoudre la plupart des problèmes rencontrés lors de l’installation ou des mises à jour.
Résumé
- Assurez-vous que la virtualisation est activée dans le BIOS.
- Activez les fonctionnalités WSL et de la plateforme de machine virtuelle depuis PowerShell.
- Installez/mettez à jour manuellement le noyau Linux WSL2.
- Utilisez des commandes comme celle-ci
wsl --list --verbosepour vérifier votre configuration. - Installez les distributions Linux directement via PowerShell si le Microsoft Store n’est pas une option.
Conclure
Configurer correctement WSL peut parfois s’avérer un peu fastidieux, surtout si le BIOS ou Windows fait des siennes. Mais une fois en place, tout s’enchaîne à merveille.Étrangement, les méthodes manuelles sont souvent plus efficaces que les solutions automatiques. Et si vous n’êtes pas à l’aise avec la manipulation du BIOS ou de PowerShell, n’hésitez pas à demander de l’aide ou à vérifier la compatibilité de votre matériel. WSL transforme véritablement Windows en un environnement de type dual-boot, sans les complications liées aux partitions : c’est plutôt pratique.
J’espère que cela évitera à quelqu’un quelques heures de frustration. Bonne chance !