Aller au contenu
English
Compte : non connecté, synchronisation possible Mon apprentissage
Selectionner le thème
English
Read in English

Installer WSL2 sur Windows 11 (ou Windows 10) pour un Linux local

Par mis à jour le

Améliorer 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.

Ce guide vous accompagne dans l'installation et la configuration de WSL2, des prérequis matériels jusqu'aux applications graphiques :

CompétenceCe que vous saurez faire
Vérifier les prérequisConfirmer que votre PC supporte WSL2
Activer la virtualisationConfigurer le BIOS si nécessaire
Installer WSL2Une commande pour tout configurer
Ouvrir UbuntuCréer votre utilisateur Linux et mettre le système à jour
Choisir une distributionUbuntu par défaut, ou une autre du catalogue Microsoft
Gérer ses distributionsLister, arrêter, sauvegarder et restaurer
Lancer des apps graphiquesExécuter des applications Linux avec interface
Installation hors-ligneInstaller WSL sans connexion Internet

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).

AspectWSL1WSL2
ArchitectureCouche de traductionVrai noyau Linux
Lecture/écriture (I/O) des fichiers LinuxMoyennesÉlevées
Lecture/écriture (I/O) des fichiers WindowsÉlevéesMoyennes
CompatibilitéPartielleQuasi totale
RAM utiliséeMinimaleDynamique (jusqu'à 50 % de la RAM par défaut)

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.

  1. 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.

  2. Trouvez le paramètre de virtualisation

    Le nom et l'emplacement varient selon le constructeur :

    ConstructeurTouche BIOSEmplacementNom du paramètre
    ASUSF2 / SupprAdvanced → CPU ConfigurationIntel VT-x / SVM Mode
    DellF2Virtualization SupportEnable Virtualization
    HPF10 / ÉchapSystem Configuration → Device ConfigurationVirtualization Technology
    LenovoF1 / F2Security → VirtualizationIntel VT-x / AMD-V
    MSISupprOC → CPU FeaturesSVM Mode / Intel VT-x
    AcerF2AdvancedIntel VT / AMD SVM
    GigabyteSupprM.I.T → Advanced CPU SettingsSVM / VT-x

    Ce tableau résume les accès les plus courants. Le paramètre doit être sur Enabled.

  3. Sauvegardez et redémarrez

    Généralement F10 → Save & Exit.

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.

  1. Ouvrez PowerShell en administrateur

    • Clic droit sur Démarrer → Terminal Windows (Admin)
    • Ou : Win+X → Terminal (Admin)
  2. 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
  3. Redémarrez votre PC

    Fenêtre de terminal
    Restart-Computer
  4. 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:
  5. 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
    sudo apt update && sudo apt upgrade -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).

  1. Activez les fonctionnalités Windows requises

    En PowerShell administrateur :

    Fenêtre de terminal
    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  2. Redémarrez

    Fenêtre de terminal
    Restart-Computer
  3. Téléchargez le paquet de mise à jour du noyau

    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.

  4. Définissez WSL2 comme version par défaut

    Fenêtre de terminal
    wsl --set-default-version 2
  5. 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 :

    Fenêtre de terminal
    Invoke-WebRequest -Uri https://aka.ms/wslubuntu2204 -OutFile Ubuntu.appx -UseBasicParsing
    Invoke-WebRequest -Uri https://aka.ms/wsl-debian-gnulinux -OutFile Debian.appx -UseBasicParsing

    Sur la machine cible, installez le paquet puis lancez la distribution :

    Fenêtre de terminal
    Add-AppxPackage .\Ubuntu.appx

    Renommer le .appx en .zip pour l'extraire n'est que la variante de Windows Server, où Add-AppxPackage n'est pas disponible.

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.

Fenêtre de terminal
# Lister les distributions installées
wsl --list --verbose
# Lancer une distribution spécifique
wsl -d Ubuntu
# Définir la distribution par défaut
wsl --set-default Ubuntu
# Arrêter toutes les distributions
wsl --shutdown
# Arrêter une distribution spécifique
wsl --terminate Ubuntu

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.

Fenêtre de terminal
# Vérifier la version de WSL
wsl --version
# Convertir une distribution WSL1 → WSL2
wsl --set-version Ubuntu 2
# Mettre à jour WSL
wsl --update

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 :

DepuisVersChemin
WindowsLinux\\wsl.localhost\Ubuntu\home\user\
LinuxWindows/mnt/c/Users/VotreNom/

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.

Fenêtre de terminal
# Dans WSL2, vérifiez que DISPLAY est configuré
echo $DISPLAY
# Doit afficher quelque chose comme :0

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
sudo apt update && sudo apt upgrade -y
# Installer un éditeur graphique (exemple : GNOME Text Editor)
sudo apt install gnome-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
sudo apt install nautilus -y
# Éditeur de code (léger)
sudo apt install geany -y
# Terminal avancé
sudo apt install terminator -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.

Un PC Windows contient le fichier .wslconfig, qui règle la mémoire, les processeurs et le swap de la machine virtuelle WSL2. Cette machine virtuelle est unique et contient deux distributions, Ubuntu et Debian. Chacune porte son propre fichier /etc/wsl.conf, pour systemd et les montages.PC Windows.wslconfigdossier utilisateurMachine virtuelle WSL2 communeUbuntuDebian/etc/wsl.confsystemd, montages/etc/wsl.confsystemd, montagesmémoire, CPU, swap
Source · SVG
Échap pour fermer, + et − pour zoomer, défilement pour se déplacer. 100 %

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

[wsl2]
memory=4GB
processors=2
swap=2GB
localhostForwarding=true

Après modification, redémarrez WSL :

Fenêtre de terminal
wsl --shutdown

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
  • Génère automatiquement /etc/resolv.conf

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.

  1. Installez l'extension Remote - WSL

    Dans VS Code, installez "Remote - WSL" (ou "WSL" dans les versions récentes).

  2. 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"

  3. 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.

ErreurCause probableSolution
"Virtualization disabled"BIOS mal configuréActiver VT-x/AMD-V dans le BIOS
"WSL 2 requires an update"Kernel obsolètewsl --update
"The requested operation requires elevation"Droits insuffisantsLancer PowerShell en admin
Aucune fenêtre Ubuntu après le redémarrageL'installation d'Ubuntu ne s'est pas terminéeTaper Ubuntu dans le menu Démarrer ; sinon relancer wsl --install -d Ubuntu
Distribution qui ne démarre pasRAM insuffisante sur l'hôte WindowsRéduire memory dans .wslconfig
Réseau non disponibleVPN interférenceDésactiver le VPN ou configurer le pare-feu

Si une distribution est corrompue, la seule remise à zéro passe par sa désinscription, qui efface tout : exportez d'abord ce qui compte.

Fenêtre de terminal
# Désinscrire (supprime les données !)
wsl --unregister Ubuntu
# Réinstaller
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)
wsl --import Ubuntu C:\WSL\Ubuntu D:\Backups\ubuntu.tar

Utilisez cette liste pour valider que votre installation de WSL2 est complète et fonctionnelle. Chaque point correspond à une étape à ne pas sauter.

  • Windows 11, ou Windows 10 2004+
  • Virtualisation activée dans le BIOS
  • wsl --install exécuté avec succès
  • Distribution configurée (utilisateur + mot de passe)
  • Ubuntu ouvert, prompt votre_nom@PC:~$ visible, paquets mis à jour
  • wsl --list --verbose affiche la distribution en version 2
  • Accès réseau fonctionnel (sudo apt update a réussi à l'étape 5)
  • .wslconfig créé pour limiter la RAM (optionnel)

Ces points résument ce qu'il faut garder en tête pour utiliser WSL2 au quotidien, de l'installation à la sauvegarde.

ConceptPoint clé
WSL2Noyau Linux réel dans une machine virtuelle légère, pas une émulation
Installationwsl --install fait tout en une commande, puis le PC redémarre
Premier lancementUtilisateur créé, mot de passe invisible à la saisie, paquets mis à jour avec sudo apt update && sudo apt upgrade -y
FichiersTravaillez dans le système de fichiers natif de votre app
RessourcesLimitez la RAM via .wslconfig si nécessaire
Applications graphiquesWSLg, sur Windows 11 ou Windows 10 build 19044+
VS CodeExtension WSL pour développer nativement
Sauvegardewsl --export avant toute manipulation risquée

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

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.