Installer WSL2 sur Windows 10 et 11 pour un Linux local

WSL2 (Windows Subsystem for Linux 2) vous permet d'exécuter Linux directement dans Windows, sans dual-boot ni machine virtuelle lourde. Vous conservez votre environnement Windows tout en accédant aux outils Linux (bash, Docker, Python, etc.). L'installation prend moins de 10 minutes : une seule commande suffit sur Windows 11.

En résumé

WSL2 = Linux natif dans Windows. Idéal pour le développement, l'apprentissage DevOps et l'utilisation d'outils CLI Linux sans quitter Windows.

Ce que vous allez apprendre

Ce guide vous accompagne dans l'installation et la configuration de WSL2 :

Compétence	Ce que vous saurez faire
Vérifier les prérequis	Confirmer que votre PC supporte WSL2
Activer la virtualisation	Configurer le BIOS si nécessaire
Installer WSL2	Une commande pour tout configurer
Choisir une distribution	Ubuntu, Debian, Fedora...
Lancer des apps graphiques	Exécuter des applications Linux avec interface
Installation hors-ligne	Installer WSL sans connexion Internet

Glissez pour voir

Comprendre WSL2

WSL1 vs WSL2 : quelle différence ?

Les deux versions cohabitent toujours 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. Les deux lignes de performance du tableau se lisent donc en miroir : la traduction de WSL1 lit vite les fichiers Windows mais mal les fichiers Linux, la VM de WSL2 fait exactement l'inverse parce que ses fichiers Linux vivent dans un disque virtuel et que l'accès à C: passe par un protocole réseau.

Aspect	WSL1	WSL2
Architecture	Couche de traduction	Vrai noyau Linux
Performances I/O Linux	Moyennes	Élevées
Performances I/O Windows	Élevées	Moyennes
Compatibilité	Partielle	Complète
Docker	Non supporté	Oui, Natif
RAM utilisée	Minimale	Dynamique (2GB+)

Glissez pour voir

Recommandation : utilisez WSL2 sauf si vous travaillez intensivement sur des fichiers stockés côté Windows (dans ce cas, WSL1 peut être plus rapide pour l'accès fichiers).

Pourquoi WSL2 ?

WSL2 utilise un vrai noyau Linux compilé par Microsoft. Cela permet une compatibilité quasi-totale avec les applications Linux, y compris Docker qui nécessite les fonctionnalités kernel.

Prérequis

Version Windows requise

WSL2 nécessite Windows 10 version 2004+ ou Windows 11. Le numéro qui compte n'est pas « Windows 10 » mais le numéro de build affiché par la commande ci-dessous : c'est lui que le programme d'installation contrôle, et une machine restée sur une build antérieure à 19041 refusera l'installation même si elle affiche bien Windows 10.

winver

Vous devez voir au minimum :

• Windows 10 : Version 2004 (Build 19041 ou supérieur)
• Windows 11 : Toutes versions supportées

Activer la virtualisation (BIOS/UEFI)

WSL2 utilise Hyper-V, qui nécessite la virtualisation matérielle. Si vous obtenez une erreur lors de l'installation, vérifiez ce paramètre.

1. Redémarrez votre PC et accédez au BIOS/UEFI

   La touche dépend du fabricant (affichée au démarrage) :

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

3. Sauvegardez et redémarrez

   Généralement F10 → Save & Exit.

Si vous ne trouvez pas l'option

Sur certains PC portables d'entrée de gamme, la virtualisation peut être masquée ou désactivée sans possibilité de modification. Consultez le support du fabricant.

Installation de WSL2

Méthode standard (avec Internet)

Une seule commande PowerShell administrateur enchaîne l'activation des fonctionnalités Windows, le téléchargement du noyau et l'installation d'une distribution. Le point important est le redémarrage entre l'étape 2 et l'étape 4 : les fonctionnalités Microsoft-Windows-Subsystem-Linux et VirtualMachinePlatform ne sont réellement actives qu'au boot suivant, et lancer Ubuntu avant ce redémarrage produit une erreur qui ressemble à un échec d'installation.

1. Ouvrez PowerShell en administrateur

   • Clic droit sur Démarrer → Terminal Windows (Admin)
   • Ou : Win+X → Terminal (Admin)

2. Lancez l'installation

   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

   Restart-Computer

4. Configurez Ubuntu au premier lancement

   Au redémarrage, Ubuntu se lance automatiquement. Créez votre utilisateur Linux :

   Enter new UNIX username: votre_nom
   New password: ********

Choisir une autre distribution

Pour installer Debian au lieu d'Ubuntu :

wsl --install -d Debian

Listez les distributions disponibles avec wsl --list --online.

Méthode hors-ligne (sans Internet)

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 les deux fonctionnalités Windows, poser le paquet de noyau, puis fournir la distribution sous forme de fichier. Prévoyez un poste connecté pour récupérer les deux fichiers et un moyen de transfert (clé USB, partage interne).

1. Activez les fonctionnalités Windows requises

   En PowerShell administrateur :

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

2. Redémarrez

   Restart-Computer

3. Téléchargez le kernel Linux

   Sur un PC connecté, téléchargez : https://aka.ms/wsl2kernel

   Transférez le fichier .msi et installez-le.

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

   wsl --set-default-version 2

5. Installez une distribution manuellement

   Téléchargez le fichier .appx depuis le Microsoft Store (sur un PC connecté) :

   Distribution	Lien de téléchargement
   Ubuntu 24.04 LTS	Microsoft Store
   Debian	Microsoft Store

   Glissez pour voir

   Renommez le fichier .appx en .zip, extrayez-le et lancez l'exécutable.

Commandes essentielles

Voici les commandes PowerShell indispensables pour gérer WSL au quotidien. Toutes s'exécutent depuis un terminal Windows (pas besoin d'être dans WSL).

Gérer les distributions

Une fois WSL installé, vous pouvez avoir plusieurs distributions Linux côte à côte. Ces commandes vous permettent de les lister, démarrer, arrêter ou basculer entre elles.

# 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

Gérer les versions WSL

Vous pouvez convertir une distribution existante de WSL1 vers WSL2 (ou inversement) sans la réinstaller. C'est utile si vous avez migré depuis une ancienne version de Windows.

# Vérifier la version de WSL
wsl --version

# Convertir une distribution WSL1 → WSL2
wsl --set-version Ubuntu 2

# Mettre à jour WSL
wsl --update

Accéder aux fichiers

Les systèmes de fichiers sont accessibles des deux côtés :

Depuis	Vers	Chemin
Windows	Linux	\\wsl$\Ubuntu\home\user\
Linux	Windows	/mnt/c/Users/VotreNom/

Glissez pour voir

Performances fichiers

Pour de meilleures performances, travaillez sur les fichiers du système où tourne votre application. Un projet Node.js dans WSL2 doit être dans /home/user/, pas dans /mnt/c/.

Applications graphiques Linux

Depuis Windows 11, WSL2 exécute les applications graphiques Linux nativement grâce à WSLg, un composant qui démarre en même temps que la distribution et relaie l'affichage vers le bureau Windows. Aucun serveur X tiers à installer, aucune variable à exporter : une fenêtre Linux apparaît comme une fenêtre Windows ordinaire, avec son entrée dans la barre des tâches. Sur Windows 10, WSLg n'est pas disponible et il faut passer par un serveur X externe.

Vérifier le support

WSLg fournit un serveur d'affichage Wayland et un pont X11 dans la distribution. Le test le plus rapide consiste à lire 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é. La cause la plus fréquente est un WSL trop ancien, que wsl --update corrige.

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

Installer une application graphique

Une application graphique Linux s'installe exactement 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 des paquets sert surtout à récupérer les bibliothèques GTK ou Qt dont dépend l'application.

# Mettre à jour les paquets
sudo apt update && sudo apt upgrade -y

# Installer un éditeur graphique (exemple : gedit)
sudo apt install gedit -y

# Lancer l'application
gedit &

L'application s'ouvre dans une fenêtre Windows classique, avec intégration dans la barre des tâches.

Applications courantes

Voici quelques applications graphiques populaires que vous pouvez installer dans WSL2. Elles s'intègrent parfaitement à Windows : icônes dans le menu Démarrer, fenêtres redimensionnables, copier-coller entre Windows et Linux.

# 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 (ex: nautilus &). Le & permet de garder le terminal disponible.

Intégration Windows

Les applications graphiques Linux apparaissent dans le menu Démarrer Windows et peuvent être épinglées à la barre des tâches.

Configuration avancée

Limiter les ressources (.wslconfig)

Par défaut, la machine virtuelle WSL2 s'autorise une part importante de la mémoire de l'hôte et ne la rend pas spontanément à Windows. 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.

Emplacement : C:\Users\VotreNom\.wslconfig

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

Après modification, redémarrez WSL :

wsl --shutdown

Configuration par distribution (wsl.conf)

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 le fichier qui active systemd, sans lequel systemctl renvoie une erreur et où aucun service Linux ne démarre au lancement. Créez-le 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

Intégration VS Code

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 :

   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.

Dépannage

Erreurs courantes

Les messages ci-dessous sont ceux que renvoie WSL en anglais, y compris sur un Windows en français : cherchez la chaîne exacte affichée dans votre terminal. Trois d'entre eux se règlent sans toucher à la distribution (BIOS, droits, mise à jour du noyau) ; les deux derniers touchent à la configuration de la machine virtuelle et demandent un wsl --shutdown avant que la correction prenne effet.

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
Distribution qui ne démarre pas	RAM insuffisante	Réduire memory dans .wslconfig
Réseau non disponible	VPN interférence	Désactiver le VPN ou configurer le pare-feu

Glissez pour voir

Réinitialiser une distribution

Si une distribution est corrompue :

# Désinscrire (supprime les données !)
wsl --unregister Ubuntu

# Réinstaller
wsl --install -d Ubuntu

Sauvegardez vos données

--unregister supprime définitivement tous les fichiers de la distribution. Exportez vos données importantes avant :

wsl --export Ubuntu ubuntu-backup.tar

Exporter/Importer une distribution

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

# 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

Checklist d'installation

Utilisez cette liste pour valider que votre installation WSL2 est complète et fonctionnelle. Chaque point correspond à une étape critique du processus.

• Windows 10 2004+ ou Windows 11
• Virtualisation activée dans le BIOS
• wsl --install exécuté avec succès
• Distribution configurée (utilisateur + mot de passe)
• wsl --list --verbose affiche la distribution en version 2
• Accès réseau fonctionnel (ping google.com)
• .wslconfig créé pour limiter la RAM (optionnel)

Contrôle de connaissances

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

Démarrer le quiz

Lance le quiz et démarre le chronomètre

À retenir

Ces points essentiels résument les bonnes pratiques pour utiliser WSL2 efficacement au quotidien.

Concept	Point clé
WSL2	Noyau Linux natif dans Windows, pas une émulation
Installation	wsl --install fait tout en une commande
Fichiers	Travaillez dans le système de fichiers natif de votre app
Ressources	Limitez la RAM via .wslconfig si nécessaire
VS Code	Extension WSL pour développer nativement
Sauvegarde	wsl --export avant toute manipulation risquée

Glissez pour voir

Pour aller plus loin

• Comprendre l'écosystème Nix : Ce que recouvrent Nix, nixpkgs et NixOS, à installer aussi dans une distribution WSL.
• Installer Nix : Ajouter un gestionnaire de paquets reproductible à votre Linux local.
• Administrer avec Neovim : Monter un environnement d'édition complet dans le terminal WSL.

FAQ

Qu'est-ce que WSL 2 ?

WSL 2 (Windows Subsystem for Linux 2) est une version améliorée de WSL qui intègre un véritable noyau Linux dans Windows, permettant une compatibilité accrue et de meilleures performances par rapport à WSL 1.

Quelle est la différence entre WSL 1 et WSL 2 ?

WSL 1 traduit les appels système Linux en appels système Windows, tandis que WSL 2 utilise un vrai noyau Linux exécuté dans une machine virtuelle légère, offrant une meilleure compatibilité et des performances supérieures.

Comment vérifier si la virtualisation est activée ?

La **virtualisation matérielle** (Intel VT-x ou AMD-V) est **obligatoire** pour WSL 2. ### Méthode 1 : Gestionnaire des tâches (simple) 1. Ouvrir avec **Ctrl + Shift + Esc** 2. Onglet **Performances** → **Processeur** 3. 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) ```powershell # Vérifier le support Hyper-V Get-ComputerInfo | Select-Object HyperV* # Résultat attendu HyperVisorPresent : True HyperVRequirementVirtualizationFirmwareEnabled : True ``` ### Méthode 3 : Commande systeminfo ```powershell 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).

Comment activer la virtualisation dans le BIOS/UEFI ?

Redémarrez votre PC, accédez au BIOS/UEFI, cherchez l'option Intel Virtualization Technology (ou AMD-V pour AMD) et activez-la, puis enregistrez les modifications avant de redémarrer.

Comment installer WSL 2 rapidement ?

L'installation de WSL 2 se fait en **une seule commande** depuis Windows 10 version 2004+. ### Installation rapide (recommandée) ```powershell # 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 ```powershell # 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 ```bash # 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 ```

Comment installer WSL 2 en mode déconnecté (sans Microsoft Store) ?

Pour les environnements **sans accès Internet** ou **sans Microsoft Store** (Windows Server, LTSC). ### Étape 1 : Activer les fonctionnalités Windows ```powershell # PowerShell en Administrateur dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # Redémarrer obligatoire Restart-Computer ``` ### Étape 2 : Installer le noyau WSL 2 Télécharger depuis : [aka.ms/wsl2kernel](https://aka.ms/wsl2kernel) ```powershell # Après téléchargement msiexec /i wsl_update_x64.msi /quiet ``` ### Étape 3 : Définir WSL 2 par défaut ```powershell wsl --set-default-version 2 ``` ### Étape 4 : Télécharger une distribution manuellement Depuis [Microsoft Learn](https://learn.microsoft.com/fr-fr/windows/wsl/install-manual#downloading-distributions) : | Distribution | Fichier | |--------------|---------| | Ubuntu 22.04 | `Ubuntu2204-221101.AppxBundle` | | Debian | `DebianGNULinux.appx` | ### Étape 5 : Installer la distribution ```powershell # Copier le fichier .appx sur la machine cible Add-AppxPackage -Path .\Ubuntu2204.appx # Lancer la distribution ubuntu2204.exe ``` ### Vérification ```powershell wsl --list --verbose # NAME STATE VERSION # Ubuntu-22.04 Running 2 ```

Comment configurer WSL 2 avec .wslconfig ?

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 ```ini [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 # Libérer la mémoire inutilisée pageReporting=true # Désactiver la récupération automatique de mémoire # autoMemoryReclaim=gradual # dropin, gradual, disabled # Réseau networkingMode=mirrored # NAT ou mirrored (Windows 11) # DNS dnsTunneling=true [experimental] 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 dans WSL (Docker) | true | ### Appliquer les changements ```powershell # Arrêter WSL pour appliquer wsl --shutdown # Relancer wsl ``` ### Interface graphique (Windows 11) Depuis 2024, une **application graphique** permet de configurer WSL sans éditer le fichier manuellement : ```powershell # Ouvrir les paramètres WSL wsl --manage ```

Comment exécuter des applications graphiques Linux sous WSL 2 ?

**WSLg** (Windows Subsystem for Linux GUI) permet d'exécuter des applications Linux avec interface graphique sous Windows 11. ### Prérequis | Élément | Requis | |---------|--------| | **Windows** | Windows 11 (build 22000+) ou Windows 10 22H2 | | **WSL** | Version récente (`wsl --update`) | | **GPU Driver** | Intel/AMD/NVIDIA compatible | ### Vérifier le support ```powershell # Mettre à jour WSL wsl --update # Vérifier la version wsl --version # WSLg version doit apparaître ``` ### Installer une application GUI ```bash # 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 gedit # Éditeur de texte ``` ### Lancer une application ```bash # 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 : ```bash # 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) ```

Comment utiliser Docker avec WSL 2 ?

**Docker Desktop** s'intègre nativement avec WSL 2, offrant de meilleures performances qu'avec Hyper-V. ### Installation recommandée 1. **Installer Docker Desktop** depuis [docker.com](https://docker.com) 2. Dans Settings → General : activer **Use WSL 2 based engine** 3. Dans Settings → Resources → WSL Integration : activer vos distributions ### Vérification ```bash # Depuis WSL docker --version docker run hello-world ``` ### Alternative : Docker Engine natif dans WSL Pour éviter Docker Desktop (licence) : ```bash # Installer Docker Engine dans Ubuntu WSL curl -fsSL https://get.docker.com | sh # Ajouter l'utilisateur au groupe docker sudo usermod -aG docker $USER # Démarrer le service sudo service docker start # Rendre le démarrage automatique echo 'sudo service docker start' >> ~/.bashrc ``` ### 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 ```bash # 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) ```

Comment accéder aux fichiers entre Windows et WSL ?

WSL permet un **accès bidirectionnel** entre les systèmes de fichiers Windows et Linux. ### Accéder à Windows depuis WSL ```bash # 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 ```powershell # 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 ```bash # Se placer dans le dossier du projet cd ~/projets/mon-app # Ouvrir VS Code avec Remote-WSL code . ``` ### Copier entre systèmes ```bash # 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 ``` ┌─────────────────────────────────────────┐ │ Performance d'accès aux fichiers │ ├─────────────────────────────────────────┤ │ WSL FS (ext4) ████████████████ 100% │ │ Windows → WSL ████████ 50% │ │ WSL → Windows ██████ 35% │ └─────────────────────────────────────────┘ ``` **Règle d'or** : gardez vos projets dans le système de fichiers où vous travaillez le plus.

Comment résoudre les problèmes courants de WSL 2 ?

Voici les **problèmes fréquents** et leurs solutions. ### Erreur : "WSL 2 requires an update to its kernel component" ```powershell # Télécharger et installer la mise à jour du noyau # https://aka.ms/wsl2kernel wsl --update ``` ### Erreur : "The virtual machine could not be started" ```powershell # Vérifier que Hyper-V est activé dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all # Redémarrer Restart-Computer ``` ### WSL consomme trop de mémoire ```ini # Créer/modifier C:\Users\<Nom>\.wslconfig [wsl2] memory=4GB swap=2GB [experimental] autoMemoryReclaim=gradual ``` ```powershell # Appliquer les changements wsl --shutdown ``` ### Internet ne fonctionne pas dans WSL ```bash # Vérifier le DNS cat /etc/resolv.conf # Corriger manuellement si nécessaire sudo rm /etc/resolv.conf echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf sudo chattr +i /etc/resolv.conf # Empêcher la réécriture ``` ### Réinitialiser une distribution ```powershell # 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 ```powershell # É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 ``` ### Tableau de diagnostic | Symptôme | Cause probable | Solution | |----------|----------------|----------| | Lenteur extrême | Fichiers sur /mnt/c | Déplacer vers ~/ | | Pas de réseau | DNS mal configuré | Modifier resolv.conf | | RAM saturée | Pas de limite | Configurer .wslconfig | | Erreur au démarrage | Virtualisation désactivée | Activer dans BIOS |

×

📖 Voir la documentation →