Activer et configurer WSL2

Avant d'utiliser WSL Dashboard, votre système Windows doit avoir correctement activé et configuré l'environnement WSL 2. Cette section vous guidera à travers la configuration de base nécessaire.

1. Vérifier les exigences du système

WSL 2 a des exigences minimales de version Windows. Appuyez sur Win + R, entrez winver pour vérifier votre version :

• Windows 10 : version 1903 ou supérieure, et la version de build doit être 18362 ou supérieure.
• Windows 11 : toutes les versions sont compatibles.

IMPORTANT

Si votre version est trop ancienne, mettez d'abord à jour votre système via "Windows Update".

2. Activer la virtualisation matérielle

WSL 2 fonctionne sur la base de la technologie de virtualisation, vous devez donc activer Virtualization Technology dans le BIOS/UEFI de votre carte mère.

• Méthode de vérification : Ouvrez "Gestionnaire des tâches" -> onglet "Performance" -> "CPU".
• Vérifier l'état : Confirmez que l'état "Virtualisation" en bas à droite affiche "Activé".
• Mode d'activation : Si ce n'est pas activé, vous devez redémarrer l'ordinateur et accéder aux paramètres BIOS/UEFI, rechercher une option similaire à Intel VT-x ou AMD-V et la définir sur Enabled.

3. Activer les fonctionnalités Windows associées

Vous devez activer les fonctionnalités Windows "Windows Subsystem for Linux" et "Platforme de machine virtuelle".

Méthode A : Via l'interface graphique (recommandé)

1. Appuyez sur Win + S, recherchez et ouvrez "Activer ou désactiver des fonctionnalités Windows".
2. Cochez les deux options suivantes :
   • Windows Subsystem for Linux (Sous-système Windows pour Linux)
   • Platforme de machine virtuelle (Virtual Machine Platform)
3. Cliquez sur "OK" et redémarrez l'ordinateur lorsque vous y êtes invité.

Méthode B : Via la ligne de commande (avec droits d'administrateur)

Exécutez PowerShell en tant qu'administrateur et exécutez les commandes suivantes :

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

# Activer la plateforme de machine virtuelle
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Après exécution, redémarrez manuellement l'ordinateur.

4. Installer/mettre à jour le noyau WSL

Les versions modernes de Windows peuvent obtenir des mises à jour WSL via Microsoft Store.

• URL de téléchargement : Microsoft Store - Windows Subsystem for Linux
• Téléchargement manuel : Si vous ne pouvez pas utiliser le Store, vous pouvez télécharger le package d'installation .msixbundle ou .msi le plus récent depuis WSL GitHub Releases pour une installation hors ligne.

5. Définir WSL 2 comme version par défaut

Pour garantir que les nouvelles distributions installées utilisent WSL 2 par défaut, exécutez dans le terminal :

wsl --set-default-version 2

Problèmes courants

• Erreur 0x80370102 : Généralement dû au fait que la virtualisation n'est pas activée dans le BIOS ou qu'il y a des conflits avec Hyper-V.
• Changement entre WSL 1 et WSL 2 : Vous pouvez utiliser wsl --set-version <nom de distribution> 2 pour mettre à niveau une instance WSL 1 existante vers WSL 2.