L’issue s’ouvre déjà remplie avec le titre et l’adresse de cette page.
WSL2 (Windows Subsystem for Linux 2) fait tourner Linux directement dans Windows, sans dual-boot (deux systèmes installés côte à côte, choisis au démarrage) et sans machine virtuelle lourde à gérer. Vous gardez Windows tel quel, et vous obtenez un terminal Linux avec bash, Python et tous les outils en ligne de commande qui n'existent que sous Linux. Cette page mène un PC Windows jusqu'à une fenêtre Ubuntu ouverte, avec votre utilisateur créé et le système à jour. Sur Windows 11, une seule commande suffit ; Windows 10 reste pris en charge par WSL, avec les limites signalées dans les prérequis. Pour un Linux complet dans sa propre machine virtuelle, voir plutôt
Installer une VM Linux.
Avant de taper la moindre commande, il faut savoir laquelle des deux versions
de WSL vous utilisez. Le choix se fait distribution par distribution, et il
change les performances comme la compatibilité. Cette section compare les deux
architectures, puis explique pourquoi la recommandation penche presque toujours
du même côté.
WSL1 et WSL2 cohabitent et se choisissent distribution par distribution. WSL1 traduit les appels système Linux en appels Windows. WSL2 embarque un vrai noyau Linux dans une machine virtuelle légère gérée par Hyper-V, l'hyperviseur de Windows (le logiciel qui fait tourner des machines virtuelles).
Aspect
WSL1
WSL2
Architecture
Couche de traduction
Vrai noyau Linux
Lecture/écriture (I/O) des fichiers Linux
Moyennes
Élevées
Lecture/écriture (I/O) des fichiers Windows
Élevées
Moyennes
Compatibilité
Partielle
Quasi totale
RAM utilisée
Minimale
Dynamique (jusqu'à 50 % de la RAM par défaut)
Glissez pour voir
Les deux lignes de performance se lisent en miroir. La traduction de WSL1 lit vite les fichiers Windows mais mal les fichiers Linux. La machine virtuelle de WSL2 fait l'inverse, parce que ses fichiers Linux vivent dans un disque virtuel et que l'accès à C: passe par un protocole réseau.
Utilisez donc WSL2, sauf si vous travaillez surtout sur des fichiers stockés
côté Windows : dans ce cas, WSL1 peut rester plus rapide en accès fichiers.
WSL2 embarque un noyau Linux compilé et distribué par Microsoft. Les
applications Linux y trouvent ce qu'elles attendent, d'où une compatibilité
quasi totale. Les outils qui s'appuient sur le noyau en profitent : Docker
Desktop, par exemple, utilise le moteur WSL 2 pour exécuter des conteneurs Linux
sous Windows.
Deux conditions décident de tout le reste : une version de Windows assez
récente, et la virtualisation matérielle activée dans le firmware. Vérifiez
les deux avant de lancer l'installation.
WSL2 fonctionne sur Windows 11, ou sur Windows 10 version 2004 ou plus récente. Le chiffre qui compte n'est pas « Windows 10 » mais le numéro de build : une machine restée sur une build antérieure à 19041 refuse la commande wsl --install, même si elle affiche bien Windows 10. Pour le lire, appuyez sur les touches Win+R, tapez winver puis validez (la commande fonctionne aussi dans un terminal) :
Fenêtre de terminal
winver
Vous devez voir au minimum :
Windows 11 : toutes versions supportées
Windows 10 : version 2004 (build 19041 ou supérieur)
Windows 10 n'est plus supporté par Microsoft depuis le 14 octobre 2025 : seul le programme de mises à jour de sécurité étendues (ESU) fournit encore des correctifs, jusqu'au 12 octobre 2027 pour les particuliers (pages lues le 2026-11-13). WSL, lui, liste toujours Windows 10 parmi les versions prises en charge. Pour un nouveau poste, préférez Windows 11.
WSL2 s'appuie sur Hyper-V, qui exige la virtualisation matérielle du processeur (Intel VT-x ou AMD-V). Sur la plupart des PC récents, elle est déjà activée : vérifiez-le avant de toucher au BIOS. Ouvrez le Gestionnaire des tâches (Ctrl+Maj+Échap), onglet Performances, puis Processeur : la ligne Virtualisation doit afficher « Activée ».
Si elle affiche « Désactivée », ou si l'installation échoue avec une erreur de virtualisation, activez-la dans le BIOS/UEFI. C'est le menu de réglage de la carte mère, qui s'ouvre au démarrage avant Windows.
Redémarrez votre PC et accédez au BIOS/UEFI
La touche dépend du fabricant (elle s'affiche au démarrage) ; le tableau de l'étape suivante en donne les plus courantes.
Trouvez le paramètre de virtualisation
Le nom et l'emplacement varient selon le constructeur :
Constructeur
Touche BIOS
Emplacement
Nom du paramètre
ASUS
F2 / Suppr
Advanced → CPU Configuration
Intel VT-x / SVM Mode
Dell
F2
Virtualization Support
Enable Virtualization
HP
F10 / Échap
System Configuration → Device Configuration
Virtualization Technology
Lenovo
F1 / F2
Security → Virtualization
Intel VT-x / AMD-V
MSI
Suppr
OC → CPU Features
SVM Mode / Intel VT-x
Acer
F2
Advanced
Intel VT / AMD SVM
Gigabyte
Suppr
M.I.T → Advanced CPU Settings
SVM / VT-x
Glissez pour voir
Ce tableau résume les accès les plus courants. Le paramètre doit être sur Enabled.
Deux chemins mènent au même résultat, et le choix dépend de votre accès
réseau. Sur un poste connecté, wsl --install enchaîne seul
l'activation des fonctionnalités, le téléchargement du noyau et la pose d'une
distribution. Derrière un proxy filtrant ou sur un poste isolé, la même
séquence se refait à la main, fichier par fichier. Commencez par la méthode
standard : la méthode hors-ligne n'a de sens que si celle-ci échoue au
téléchargement.
Une seule commande PowerShell lancée en administrateur active les fonctionnalités Windows, télécharge le noyau et installe une distribution. Cinq étapes mènent du PC vierge à une fenêtre Ubuntu ouverte. Le point à ne pas rater est le redémarrage entre l'étape 2 et l'étape 4 : Microsoft demande de redémarrer le PC après wsl --install, et l'installation d'Ubuntu se poursuit à ce redémarrage.
Ouvrez PowerShell en administrateur
Clic droit sur Démarrer → Terminal Windows (Admin)
Ou : Win+X → Terminal (Admin)
Lancez l'installation
Fenêtre de terminal
wsl --install
Cette commande :
Active les fonctionnalités Windows requises
Télécharge le noyau Linux WSL2
Installe Ubuntu comme distribution par défaut
Redémarrez votre PC
Fenêtre de terminal
Restart-Computer
Configurez Ubuntu au premier lancement
Au redémarrage, Ubuntu se lance seul et termine son installation, ce qui prend quelques minutes. Si aucune fenêtre ne s'ouvre, tapez Ubuntu dans le menu Démarrer et cliquez sur l'application. Ubuntu vous demande de créer votre utilisateur Linux, puis un mot de passe. Quand vous tapez le mot de passe, rien ne s'affiche, pas même des points : c'est normal. Tapez-le quand même, puis confirmez-le. Retenez-le, car Linux vous le redemandera.
Enter new UNIX username: votre_nom
New password:
Retype new password:
Vérifiez le prompt et mettez Ubuntu à jour
Quand l'installation est finie, la fenêtre affiche un prompt comme votre_nom@PC:~$ : votre utilisateur, le nom de votre PC, puis le dossier courant. Vous êtes dans un terminal Linux. Mettez les paquets à jour avant de continuer. La commande sudo demande votre mot de passe, toujours sans rien afficher :
Fenêtre de terminal
sudoaptupdate && sudoaptupgrade-y
Pour rouvrir Ubuntu après une fermeture, tapez Ubuntu dans le menu Démarrer, ou wsl dans PowerShell. La leçon Ouvrir un terminal et comprendre le prompt explique comment lire ce prompt.
Pour vérifier que Ubuntu tourne bien en WSL2, ouvrez PowerShell et lancez wsl --list --verbose : la colonne VERSION doit afficher 2.
Ubuntu n'est que la distribution par défaut, pas un passage obligé. L'option
-d en installe une autre, et vous pouvez en poser plusieurs côte à côte sur la
même machine :
Fenêtre de terminal
wsl --install -d Debian
La commande wsl --list --online affiche le catalogue des noms acceptés par
-d. C'est la seule liste qui fasse foi : un nom trouvé ailleurs échoue si
l'image n'est pas publiée pour votre version de WSL. Si le téléchargement reste
bloqué à 0,0 %, Microsoft conseille wsl --install --web-download -d <Distribution>.
En environnement déconnecté ou derrière un proxy filtrant, wsl --install échoue au moment du téléchargement du noyau. La procédure ci-dessous refait à la main ce que la commande automatise : activer deux fonctionnalités Windows, poser le paquet de noyau, puis fournir la distribution sous forme de fichier. Microsoft la documente sous le titre Manual installation steps for older versions of WSL. Prévoyez un poste connecté pour récupérer les deux fichiers, et un moyen de les transférer (clé USB, partage interne).
Sur un PC connecté, téléchargez le paquet officiel de votre architecture,
wsl_update_x64.msi ou wsl_update_arm64.msi, depuis la page
Manual installation steps
de Microsoft Learn. Transférez le fichier .msi et installez-le.
Définissez WSL2 comme version par défaut
Fenêtre de terminal
wsl --set-default-version 2
Installez une distribution manuellement
La page Microsoft Store d'une distribution ne permet pas de télécharger son
paquet. Prenez le lien direct publié dans la section
Downloading distributions
de la même page, par exemple pour Ubuntu 22.04 et Debian :
Voici les commandes PowerShell dont vous aurez besoin au quotidien. Elles s'exécutent toutes depuis un terminal Windows, pas depuis WSL : elles peuvent donc agir sur une distribution arrêtée.
Une fois WSL installé, vous pouvez avoir plusieurs distributions Linux côte à côte. Ces commandes les listent, les démarrent, les arrêtent ou changent la distribution par défaut, chacune par son nom.
Vous pouvez convertir une distribution existante de WSL1 vers WSL2 (ou l'inverse) sans la réinstaller. C'est utile si vous avez migré depuis une ancienne version de Windows.
Les systèmes de fichiers sont accessibles des deux côtés. Côté Windows, deux
chemins mènent à la distribution : \\wsl.localhost\ et l'ancien \\wsl$\. Ils
pointent au même endroit, et la distribution doit être démarrée. Le tableau
donne le premier :
WSL2 exécute les applications graphiques Linux grâce à WSLg, un composant qui démarre en même temps que la distribution et relaie l'affichage vers le bureau Windows. Une fenêtre Linux apparaît comme une fenêtre Windows ordinaire, avec son entrée dans la barre des tâches. Il n'y a aucun serveur X tiers à installer, ni variable à exporter.
Microsoft Learn en fixe le prérequis : Windows 11 ou Windows 10 build 19044 ou supérieure, un WSL à jour, et le pilote de carte graphique du fabricant (Intel, AMD ou NVIDIA) installé côté Windows.
WSLg fournit un serveur d'affichage Wayland et un pont X11 dans la distribution. Pour le tester, lisez la variable DISPLAY : si elle est vide, WSLg n'est pas actif et aucune fenêtre ne s'ouvrira, quel que soit le paquet installé. Une cause possible est un WSL trop ancien, que wsl --update corrige.
Une application graphique Linux s'installe comme une application en ligne de commande, avec le gestionnaire de paquets de la distribution. Aucune configuration d'affichage n'est nécessaire. La mise à jour préalable de l'index des paquets (apt update) évite d'installer une version périmée, et apt install ajoute de lui-même les bibliothèques GTK ou Qt dont l'application dépend.
Fenêtre de terminal
# Mettre à jour les paquets
sudoaptupdate && sudoaptupgrade-y
# Installer un éditeur graphique (exemple : GNOME Text Editor)
sudoaptinstallgnome-text-editor-y
# Lancer l'application
gnome-text-editor &
L'application s'ouvre dans une fenêtre Windows classique, avec intégration dans la barre des tâches.
Voici quelques applications graphiques courantes à installer dans WSL2. Elles s'intègrent à Windows : icônes dans le menu Démarrer, fenêtres redimensionnables, copier-coller entre Windows et Linux.
Fenêtre de terminal
# Navigateur de fichiers
sudoaptinstallnautilus-y
# Éditeur de code (léger)
sudoaptinstallgeany-y
# Terminal avancé
sudoaptinstallterminator-y
Après installation, lancez chaque application par son nom dans le terminal
WSL, par exemple nautilus &. L'esperluette & rend la main au terminal au
lieu de le bloquer tant que la fenêtre reste ouverte.
Le terminal n'est pas indispensable ensuite : ces applications apparaissent
dans le menu Démarrer de Windows, au milieu des applications Windows, et
s'épinglent à la barre des tâches comme les autres. WSLg publie ces raccourcis à
partir des fichiers .desktop installés par le paquet.
Deux fichiers de configuration cohabitent, et il est facile de les confondre.
Le schéma montre où vit chacun : .wslconfig est un fichier Windows, unique,
qui règle la machine virtuelle commune à toutes les distributions ; chaque
distribution a son propre /etc/wsl.conf, qui ne concerne qu'elle.
Retenez la règle de partage : tout ce qui touche à la mémoire, aux
processeurs et au réseau de la VM est global, tout ce qui touche à systemd et
aux montages est local.
Par défaut, la machine virtuelle WSL2 peut utiliser jusqu'à 50 % de la mémoire de l'hôte, plus une swap de 25 % de cette mémoire. Le fichier .wslconfig fixe un plafond, ce qui évite qu'une compilation dans WSL fasse ramer le reste du poste. Il s'applique à toutes les distributions à la fois, contrairement à wsl.conf traité juste après. Les versions récentes proposent aussi l'application Paramètres WSL, dans le menu Démarrer, qui écrit ce même fichier.
Le fichier se crée à cet emplacement : C:\Users\VotreNom\.wslconfig
Là où .wslconfig règle la machine virtuelle globale côté Windows, /etc/wsl.conf se place à l'intérieur de chaque distribution et ne concerne qu'elle. C'est lui qui active systemd, le gestionnaire de services de Linux. Microsoft indique que de nombreuses distributions, Ubuntu compris, le lancent par défaut. Sur une distribution qui ne l'active pas, sans ce réglage, systemctl renvoie une erreur et aucun service Linux ne démarre au lancement.
Microsoft précise que la section [boot] n'est disponible que sur Windows 11 et Windows Server 2022. Créez le fichier avec les droits root :
[boot]
systemd=true
[automount]
enabled=true
root=/mnt/
options="metadata,umask=22,fmask=11"
[network]
generateResolvConf=true
Cette configuration :
Active systemd (services Linux)
Configure le montage automatique des lecteurs Windows
VS Code fonctionne ici en mode client-serveur : l'interface reste une application Windows, mais un serveur VS Code est installé automatiquement dans la distribution Linux et c'est lui qui exécute le terminal, les extensions, le débogueur et les outils de langage. Conséquence pratique : les extensions doivent être installées côté WSL, et une extension présente côté Windows peut apparaître grisée tant que vous ne l'avez pas activée dans le contexte distant.
Installez l'extension Remote - WSL
Dans VS Code, installez "Remote - WSL" (ou "WSL" dans les versions récentes).
Ouvrez un projet WSL
Depuis WSL :
Fenêtre de terminal
cd~/mon-projet
code.
Ou depuis VS Code : Ctrl+Shift+P → "WSL: Connect to WSL"
Développez nativement
VS Code s'exécute côté Windows mais tous les outils (terminal, extensions) tournent dans WSL.
Les pannes WSL traitées ici se rangent dans trois familles : une
virtualisation absente ou désactivée, un composant obsolète que wsl --update
remet à niveau, et une distribution dont l'état interne est cassé. La
sous-section « Erreurs courantes » traite surtout les deux premières, par un
tableau de correspondance. La troisième se règle par la remise à zéro, qui
détruit les données et se prépare donc avant d'être lancée.
La première colonne résume des messages dont la formulation exacte varie avec la version de WSL et la langue de Windows : cherchez le mot-clé (virtualisation, update, elevation) dans ce que votre terminal affiche. Les trois premières erreurs se règlent hors de la distribution (BIOS, droits, mise à jour de WSL). La quatrième concerne l'installation d'Ubuntu elle-même. La cinquième modifie la configuration de la machine virtuelle : elle demande un wsl --shutdown avant que la correction prenne effet. La dernière relève du réseau et du VPN.
Erreur
Cause probable
Solution
"Virtualization disabled"
BIOS mal configuré
Activer VT-x/AMD-V dans le BIOS
"WSL 2 requires an update"
Kernel obsolète
wsl --update
"The requested operation requires elevation"
Droits insuffisants
Lancer PowerShell en admin
Aucune fenêtre Ubuntu après le redémarrage
L'installation d'Ubuntu ne s'est pas terminée
Taper Ubuntu dans le menu Démarrer ; sinon relancer wsl --install -d Ubuntu
wsl --export produit une archive .tar contenant l'intégralité du système de fichiers de la distribution : paquets installés, fichiers personnels, configuration. C'est le mécanisme de sauvegarde fourni en standard, et il sert autant à migrer vers un autre poste qu'à déplacer une distribution sur un autre disque quand C: sature. À l'import, le deuxième argument est le répertoire de destination du disque virtuel, pas un fichier : donnez un dossier vide.
Fenêtre de terminal
# Sauvegarder
wsl --export Ubuntu D:\Backups\ubuntu.tar
# Restaurer (sur un autre PC ou après réinstallation)
Vérifiez que l'essentiel de ce guide est acquis. Les questions portent
uniquement sur ce qui vient d'être expliqué ici.
Contrôle de connaissances
Validez vos connaissances avec ce quiz interactif
6 questions
6 min.
70% requis
Informations
Le chronomètre démarre au clic sur Démarrer
Questions à choix multiples, vrai/faux et réponses courtes
Vous pouvez naviguer entre les questions
Les résultats détaillés sont affichés à la fin
Lance le quiz et démarre le chronomètre
⏱️--:--
0 / 6
Vérification
(0/0)
--:--
0%
0Correctes
0À revoir
0:00Temps
-Niveau
Score par domaine
Un domaine regroupe plusieurs guides et reçoit plusieurs questions : son score est plus fiable qu'un score par thème, qui porte souvent sur une seule question.
Bilan
Points forts
Aucun sujet réussi à 80 % sur au moins deux questions pour l’instant.
Ces questions reviennent souvent après une première installation, et
portent sur des points que le guide traite à des endroits différents : le
choix entre WSL1 et WSL2, l'accès aux fichiers Windows depuis Linux et
l'utilisation de Docker dans la distribution.
WSL 2 (Windows Subsystem for Linux 2) est une couche de compatibilité permettant d'exécuter un environnement Linux complet directement sous Windows, sans machine virtuelle traditionnelle.
Architecture
┌─────────────────────────────────┐
│ Applications Linux │
├─────────────────────────────────┤
│ Noyau Linux (réel) │
├─────────────────────────────────┤
│ Machine virtuelle légère │
├─────────────────────────────────┤
│ Windows (Hyper-V) │
└─────────────────────────────────┘
Caractéristiques clés
Noyau Linux réel : compatibilité totale avec les applications Linux
Performances : accès rapide au système de fichiers Linux
Intégration Windows : accès aux fichiers Windows depuis Linux et vice-versa
Applications GUI : support des applications graphiques Linux sous Windows 11 et Windows 10 build 19044+
Cas d'usage
Développement : environnement Linux sans quitter Windows
WSL 1 et WSL 2 utilisent des architectures fondamentalement différentes.
Comparaison
Aspect
WSL 1
WSL 2
Architecture
Couche de traduction (syscalls)
Vrai noyau Linux dans VM légère
Compatibilité
Partielle (traduction des appels système)
Complète (vrai noyau Linux)
Performances FS Linux
Lent
Rapide (natif)
Performances FS Windows
Rapide
Plus lent (9p protocole)
Mémoire
Partagée avec Windows
VM avec allocation dynamique
Applications GUI
Non
Oui (Windows 11, Windows 10 build 19044+)
Quand choisir WSL 1 ?
Projets stockés sur le disque Windows (/mnt/c/)
Ressources mémoire limitées
Quand choisir WSL 2 ? (recommandé)
Développement Linux : compilation, tests
Conteneurs : Docker, Podman
Applications GUI : VS Code Remote, GIMP
Compatibilité maximale : tous les outils Linux
Commande pour changer de version
# Passer une distribution en WSL 2
wsl --set-version Ubuntu 2
# Définir WSL 2 par défaut
wsl --set-default-version 2
La virtualisation matérielle (Intel VT-x ou AMD-V) est obligatoire pour WSL 2.
Méthode 1 : Gestionnaire des tâches (simple)
Ouvrir avec Ctrl + Shift + Esc
Onglet Performances → Processeur
Chercher la ligne Virtualisation
Valeur
Signification
Activée
Prêt pour WSL 2
Désactivée
Activer dans le BIOS
Méthode 2 : PowerShell (détaillée)
# Vérifier le support Hyper-V
Get-ComputerInfo | Select-Object HyperV*
# Résultat attendu
HyperVisorPresent : True
HyperVRequirementVirtualizationFirmwareEnabled : True
Méthode 3 : Commande systeminfo
systeminfo | Select-String "Hyper-V"
# Résultat attendu : toutes les lignes à "Oui"
Configuration requise pour Hyper-V: Oui
Si la virtualisation est désactivée
Vous devez l'activer dans le BIOS/UEFI de votre machine (voir question suivante).
L'activation dépend de la marque de votre ordinateur et du type de processeur (Intel ou AMD).
Étape 1 : Accéder au BIOS/UEFI
Marque
Touche(s) au démarrage
ASUS
F2 ou DEL
Acer
F2 ou DEL
Dell
F2 ou F12
HP
ESC ou F10
Lenovo
F2 ou F1 (ThinkPad: Entrée + F1)
MSI
DEL
Samsung
F2
Étape 2 : Trouver l'option virtualisation
Processeur
Nom de l'option
Intel
Intel Virtualization Technology (VT-x)
AMD
AMD-V ou SVM Mode
Emplacements possibles :
Advanced Settings → CPU Configuration
Security → Virtualization
BIOS Features → Intel VT-x
Étape 3 : Activer et sauvegarder
Changer la valeur sur Enabled
Appuyer sur F10 (Save & Exit)
Redémarrer le PC
Vérification après redémarrage
# Doit retourner "Activée"
(Get-CimInstance Win32_Processor).VirtualizationFirmwareEnabled
L'installation de WSL 2 se fait en une seule commande depuis Windows 10 version 2004+.
Installation rapide (recommandée)
# Ouvrir PowerShell en Administrateur
# Installer WSL + Ubuntu par défaut
wsl --install
Cette commande :
Active les fonctionnalités Windows nécessaires
Télécharge le noyau Linux WSL 2
Installe Ubuntu depuis Microsoft Store
Choisir une autre distribution
# Lister les distributions disponibles
wsl --list --online
# Installer une distribution spécifique
wsl --install -d Debian
wsl --install -d kali-linux
wsl --install -d Ubuntu-22.04
Distributions populaires
Distribution
Commande
Usage
Ubuntu
wsl --install -d Ubuntu
Général, développement
Debian
wsl --install -d Debian
Serveurs, stabilité
Kali Linux
wsl --install -d kali-linux
Sécurité, pentesting
Arch Linux
Installation manuelle
Utilisateurs avancés
AlmaLinux
wsl --install -d AlmaLinux-9
Alternative RHEL
Après l'installation
# Premier lancement : créer un utilisateur
wsl
# Entrer un nom d'utilisateur et mot de passe
# Mettre à jour les paquets
sudo apt update && sudo apt upgrade -y
Pour les environnements sans accès Internet ou sans Microsoft Store (Windows Server, LTSC).
# Copier le fichier .appx sur la machine cible
Add-AppxPackage -Path .\Ubuntu2204.appx
# Lancer la distribution
ubuntu2204.exe
Vérification
wsl --list --verbose
# NAME STATE VERSION
# Ubuntu-22.04 Running 2
Le fichier .wslconfig permet de configurer les ressources allouées à WSL 2 (mémoire, CPU, swap).
Emplacement du fichier
C:\Users\<VotreNom>\.wslconfig
Configuration recommandée
[wsl2]
# Limiter la mémoire (par défaut: 50% de la RAM)
memory=8GB
# Limiter les processeurs (par défaut: tous)
processors=4
# Taille du swap
swap=4GB
# Réseau
networkingMode=mirrored # NAT ou mirrored (Windows 11)
# DNS
dnsTunneling=true
[experimental]
# Récupération de la mémoire en cache : dropCache (défaut), gradual ou disabled
autoMemoryReclaim=gradual
sparseVhd=true
Options importantes
Option
Description
Défaut
memory
RAM maximale pour WSL 2
50% de la RAM
processors
Nombre de CPU virtuels
Tous
swap
Taille du fichier swap
25% de la RAM
localhostForwarding
Accès localhost Windows → WSL
true
nestedVirtualization
VM imbriquées dans WSL 2 (Windows 11)
true
Appliquer les changements
# Arrêter WSL pour appliquer
wsl --shutdown
# Relancer
wsl
Interface graphique (Windows 11)
Les versions récentes de WSL fournissent l'application Paramètres WSL, à ouvrir depuis le menu Démarrer : Microsoft recommande de passer par elle plutôt que d'éditer le fichier à la main.
WSLg (Windows Subsystem for Linux GUI) permet d'exécuter des applications Linux avec interface graphique sous Windows 11 ou Windows 10 build 19044+.
Prérequis
Élément
Requis
Windows
Windows 11 ou Windows 10 build 19044+
WSL
Version récente (wsl --update)
GPU Driver
Intel/AMD/NVIDIA compatible
Vérifier le support
# Mettre à jour WSL
wsl --update
# Vérifier la version
wsl --version
# WSLg version doit apparaître
Installer une application GUI
# Mettre à jour les paquets
sudo apt update
# Installer des applications graphiques
sudo apt install -y gimp # Éditeur d'images
sudo apt install -y firefox # Navigateur
sudo apt install -y nautilus # Gestionnaire de fichiers
sudo apt install -y gnome-text-editor # Éditeur de texte
Lancer une application
# Depuis le terminal WSL
gimp &
firefox &
# Depuis Windows (Run dialog)
wsl gimp
Applications populaires pour WSL
Application
Installation
Usage
VS Code
code . (Remote-WSL)
Développement
GIMP
apt install gimp
Retouche image
Firefox
apt install firefox
Navigation web
VLC
apt install vlc
Lecture multimédia
LibreOffice
apt install libreoffice
Suite bureautique
Dépannage
Si les applications GUI ne s'affichent pas :
# Vérifier DISPLAY
echo $DISPLAY
# Doit retourner :0 ou similaire
# Mettre à jour le pilote GPU
# Télécharger depuis le site du fabricant (Intel/AMD/NVIDIA)
Docker Desktop s'intègre nativement avec WSL 2, offrant de meilleures performances qu'avec Hyper-V.
Dans Settings → General : activer Use WSL 2 based engine
Dans Settings → Resources → WSL Integration : activer vos distributions
Vérification
# Depuis WSL
docker --version
docker info
Alternative : Docker Engine natif dans WSL
Pour éviter Docker Desktop (licence) :Installez Docker Engine par le dépôt APT officiel décrit dans la documentation Docker (Install Docker Engine on Ubuntu), jamais par un script téléchargé et exécuté à l'aveugle, puis :
# Ajouter l'utilisateur au groupe docker
sudo usermod -aG docker $USER
# Démarrer le service et l'activer au démarrage (systemd activé dans /etc/wsl.conf)
sudo systemctl enable --now docker
Performances optimales
Conseil
Explication
Stocker les projets dans WSL
/home/user/projets/ pas /mnt/c/
Utiliser des volumes nommés
Éviter les bind mounts vers Windows
Allouer assez de RAM
.wslconfig avec memory=8GB minimum
Exemple docker-compose dans WSL
# Se placer dans le dossier Linux (pas /mnt/c/)
cd ~/projets/mon-app
# Lancer les services
docker compose up -d
# Accéder depuis Windows
# http://localhost:3000 (port forwarding automatique)
WSL permet un accès bidirectionnel entre les systèmes de fichiers Windows et Linux.
Accéder à Windows depuis WSL
# Les disques Windows sont montés dans /mnt/
ls /mnt/c/Users/
cd /mnt/c/Users/MonNom/Documents
# Exemple : copier un fichier
cp /mnt/c/Users/MonNom/fichier.txt ~/
Accéder à WSL depuis Windows
# Via l'explorateur de fichiers
\\wsl$\Ubuntu\home\monuser
# Ou depuis la barre d'adresse
\\wsl.localhost\Ubuntu
Bonnes pratiques de performance
Situation
Recommandation
Projet de dev Linux
Stocker dans ~/projets/ (WSL natif)
Fichiers partagés
Utiliser /mnt/c/ ponctuellement
Git clone
Toujours cloner côté Linux
npm/pip install
Exécuter depuis le FS Linux
Ouvrir VSCode depuis WSL
# Se placer dans le dossier du projet
cd ~/projets/mon-app
# Ouvrir VS Code avec Remote-WSL
code .
Copier entre systèmes
# Windows → WSL
cp /mnt/c/Users/MonNom/Downloads/fichier.zip ~/
# WSL → Windows
cp ~/rapport.pdf /mnt/c/Users/MonNom/Documents/
# Avec explorateur Windows
explorer.exe . # Ouvre le dossier courant dans l'explorateur
Performances
L'accès au système de fichiers Linux depuis WSL 2 est le plus rapide ; traverser la frontière, de Windows vers WSL ou de WSL vers /mnt/c/, passe par un protocole réseau et coûte nettement plus cher.Règle d'or : gardez vos projets dans le système de fichiers où vous travaillez le plus.
Voici les problèmes fréquents et leurs solutions.
Erreur : "WSL 2 requires an update to its kernel component"
# Mettre à jour WSL et son noyau
wsl --update
Erreur : "The virtual machine could not be started"
# Vérifier que Hyper-V est activé
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all
# Redémarrer
Restart-Computer
Pour fixer soi-même le DNS, désactivez d'abord la génération automatique dans /etc/wsl.conf (section [network], generateResolvConf=false), faites un wsl --shutdown depuis Windows, puis écrivez votre propre /etc/resolv.conf. Sans cette étape, WSL réécrit le fichier au prochain démarrage.
Réinitialiser une distribution
# Exporter les données importantes d'abord
wsl --export Ubuntu ubuntu-backup.tar
# Désinstaller
wsl --unregister Ubuntu
# Réinstaller
wsl --install -d Ubuntu
# Restaurer si besoin
wsl --import Ubuntu C:\WSL\Ubuntu ubuntu-backup.tar
Commandes de diagnostic
# État de WSL
wsl --status
# Lister les distributions
wsl --list --verbose
# Arrêter toutes les instances
wsl --shutdown
# Mettre à jour WSL
wsl --update
# Vérifier la version
wsl --version