← Tous les articles

Procédure wsl

Installer et configurer WSL (Windows Subsystem for Linux)

WSL permet d'exécuter un environnement Linux natif directement sous Windows, sans VM ni dual boot. Voici la procédure complète : prérequis, installation, intégration avec Windows et VS Code.

WSL (Windows Subsystem for Linux) est une fonctionnalité de Windows 10/11 qui permet d'exécuter un environnement Linux natif directement sous Windows, sans machine virtuelle ni dual boot. Contrairement à une VM classique, WSL ne nécessite pas d'hyperviseur lourd — il s'intègre au noyau Windows via une couche de compatibilité Hyper-V, avec des performances proches d'un Linux natif.

Pourquoi utiliser WSL en infrastructure ? Pour utiliser des outils Linux (bash, ssh, curl, ansible, terraform...) sans quitter Windows, tester des scripts directement sur le poste de travail, et bénéficier de l'intégration native avec VS Code, Docker Desktop et Windows Terminal.

1. Prérequis et compatibilité

Configuration requise :

ÉlémentRequis
Système d'exploitationWindows 10 ou Windows 11 version Pro
Architecturex64 ou ARM64
VirtualisationActivée dans le BIOS/UEFI (Intel VT-x ou AMD-V)
Espace disqueMinimum 2 Go (selon la distribution)

Activation d'Hyper-V

Dans la barre de recherche Windows, taper :

Recherche Windows UI
Activer ou désactiver des fonctionnalités Windows
Fenêtre Fonctionnalités Windows

Cocher Hyper-V puis cliquer sur OK.

Activation d'Hyper-V dans la liste

Windows peut demander un redémarrage une fois l'installation terminée.

2. Installation de WSL

Depuis Windows 10 version 21H2 et Windows 11, une seule commande suffit pour installer WSL 2 avec Ubuntu. À exécuter dans PowerShell (Administrateur) :

PowerShell PS
wsl --install

Cette commande installe automatiquement la fonctionnalité WSL, le noyau Linux WSL 2, et Ubuntu par défaut. Un redémarrage est nécessaire.

3. Premier démarrage et configuration

Au premier lancement d'Ubuntu, un terminal s'ouvre et lance l'initialisation. L'étape peut durer quelques minutes.

Initialisation d'Ubuntu sous WSL

Création du compte utilisateur

WSL demande de créer un compte utilisateur Linux indépendant du compte Windows :

Création du compte utilisateur Ubuntu

Bon à savoir — Le nom d'utilisateur Linux peut être différent du compte Windows. Le mot de passe ne s'affiche pas à la saisie, c'est un comportement normal sous Linux.

Mise à jour du système

Après la création du compte, mettre à jour les paquets :

Ubuntu (WSL) Bash
sudo apt update && sudo apt upgrade -y

Votre Ubuntu est maintenant à jour et prêt pour vos tests.

4. Commandes essentielles

Ces commandes s'exécutent dans PowerShell ou le Terminal Windows (pas dans WSL) :

CommandeDescription
wsl --list --verboseLister les distros installées et leur version WSL
wsl --statusAfficher l'état général de WSL
wsl --shutdownArrêter toutes les distros WSL
wsl --set-default UbuntuDéfinir la distro par défaut
wsl --unregister UbuntuSupprimer une distro (données supprimées)
wsl --updateMettre à jour le noyau WSL
wsl --install -d DebianInstaller une autre distribution
Résultat de wsl --list --verbose
Résultat de wsl --list --verbose — distro active en version 2

5. Intégration avec Windows

L'un des points forts de WSL est son intégration transparente avec le système de fichiers Windows et les outils natifs.

Accès aux fichiers Windows depuis WSL

Les disques Windows sont montés automatiquement sous /mnt/ :

Ubuntu (WSL) Bash
# Accéder au bureau Windows depuis WSL
cd /mnt/c/Users/VotreNom/Desktop

# Lister les disques montés
ls /mnt/
Accès aux fichiers Windows depuis WSL

Accès aux fichiers WSL depuis Windows

Les fichiers Linux sont accessibles depuis l'explorateur Windows via :

Explorateur Windows Path
\\wsl$\Ubuntu\home\votre_utilisateur

On peut aussi taper \\wsl$ directement dans la barre d'adresse pour voir toutes les distros installées.

Explorateur Windows affichant les fichiers WSL
Accès aux fichiers WSL depuis l'explorateur Windows

6. Intégration avec VS Code

VS Code s'intègre nativement avec WSL via l'extension WSL. Le code s'exécute côté Linux tandis que l'interface reste côté Windows.

Installation de l'extension

Dans VS Code, installer l'extension WSL directement depuis le store d'extensions.

Extension WSL dans le store VS Code

Ouvrir une distribution WSL dans VS Code

Une fois l'extension installée, un nouvel onglet Remote Explorer apparaît à gauche. VS Code reconnaît automatiquement toutes les distributions.

Onglet Remote Explorer dans VS Code

Cliquer sur la flèche : VS Code installe une extension côté WSL et ouvre une nouvelle fenêtre, avec le terminal intégré et la possibilité de naviguer dans les dossiers de la machine Linux.

VS Code connecté à une distribution WSL

Récapitulatif

AvantageDétail
LégèretéPas de VM complète, démarrage en quelques secondes
Intégration WindowsAccès bidirectionnel aux fichiers, appels croisés d'exécutables
Outils natifs LinuxBash, SSH, curl, git, python... sans émulation
VS Code & DockerIntégration native et transparente
RéseauAccès au réseau Windows, partage de ports possible

WSL est aujourd'hui mon environnement par défaut sur Windows : tout ce que je faisais en VM se fait maintenant sans switcher de fenêtre, et avec des perfs natives.