WSL : Console linux sur Windows

De Support SOFAKOM
Révision datée du 6 août 2025 à 10:45 par Gdaubeze (discussion | contributions)
(diff) ◂ Version précédente | Voir la version actuelle (diff) | Version suivante ▸ (diff)


Source : https://learn.microsoft.com/fr-fr/windows/wsl/install

Installation de WSL

Prérequis

Vous devez exécuter Windows 10 version 2004 ou ultérieure (build 19041 ou supérieure) ou Windows 11 pour utiliser les commandes ci-dessous. Pour les versions antérieures, consultez la page d’installation manuelle WSL.

Commande d’installation de WSL

Ouvrez PowerShell ou l'invite de commande Windows en mode administrateur (clic-droit → « Exécuter en tant qu’administrateur »), puis exécutez :

wsl --install

puis redémarrez votre machine.

Cette commande active les fonctionnalités nécessaires à l’exécution de WSL, télécharge et installe la distribution Linux par défaut (Ubuntu), et configure WSL 2 comme version par défaut.

Modifier la distribution Linux par défaut

Par défaut, Ubuntu est installée. Pour changer de distribution :

wsl --install -d <NomDistribution>

Par exemple : `wsl --install -d Ubuntu-20.04`

Pour afficher la liste des distributions disponibles :

wsl --list --online

ou

wsl -l -o

Installer d’autres distributions après l’installation initiale

Pour installer une distribution supplémentaire :

wsl --install -d <NomDistribution>

Ou depuis un terminal PowerShell/Bash sous Windows :

wsl.exe --install -d <NomDistribution>

et pour lister les distributions :

wsl.exe -l -o

Première exécution

Lors du premier lancement d’une distribution installée, une console s’ouvre pour initialiser les fichiers (decompression). Les lancements suivants prennent moins d’une seconde.

Changer la distribution par défaut pour la commande « wsl »

Pour définir une distribution par défaut :

wsl -s <NomDistribution>

par exemple :

wsl -s Debian

Vérifier la version de WSL

Pour lister les distributions installées et leur version WSL :

wsl -l -v

Passer de WSL 1 à WSL 2

Par défaut, une nouvelle distribution est installée en WSL 2 si `wsl --install` est disponible. Pour convertir une distribution existante :

wsl --set-version <NomDistro> 2

ex. :

wsl --set-version Ubuntu-20.04 2