Guide d’installation du sous-système Windows pour Linux pour Windows 10Windows Subsystem for Linux Installation Guide for Windows 10

Installer le sous-système Windows pour LinuxInstall Windows Subsystem for Linux

Vous avez le choix entre deux versions différentes du sous-système Windows pour Linux au cours du processus d’installation.Windows Subsystem for Linux has two different versions to choose between during the installation process. WSL 2 offre de meilleures performances globales et nous vous recommandons de l’utiliser.WSL 2 has better overall performance and we recommend using it. Si votre système ne prend pas en charge WSL 2, ou si une situation particulière nécessite un stockage de fichiers entre systèmes, vous souhaiterez peut-être utiliser WSL 1.If your system does not support WSL 2, or you have a specific situation that requires cross-system file storage, then you may want to stick with WSL 1. Découvrez plus en détail la comparaison entre WSL 2 et WSL 1.Read more about Comparing WSL 2 and WSL 1.

Étape 1 : activer le sous-système Windows pour LinuxStep 1 - Enable the Windows Subsystem for Linux

Vous devez tout d’abord installer la fonctionnalité facultative « Sous-système Windows pour Linux » avant d’installer des distributions Linux sur Windows.You must first enable the "Windows Subsystem for Linux" optional feature before installing any Linux distributions on Windows.

Ouvrez PowerShell en tant qu’administrateur et exécutez :Open PowerShell as Administrator and run:

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

Nous vous recommandons de passer à l’étape 2 : Mise à jour vers WSL 2. Toutefois, si vous souhaitez installer uniquement WSL 1, vous pouvez redémarrer maintenant votre ordinateur et passer à l’Étape 6 : Installer la distribution Linux de votre choix.We recommend now moving on to step #2, updating to WSL 2, but if you wish to only install WSL 1, you can now restart your machine and move on to Step 6 - Install your Linux distribution of choice. Pour effectuer une mise à jour vers WSL 2, attendez avant de redémarrer votre ordinateur et passez à l’étape suivante.To update to WSL 2, wait to restart your machine and move on to the next step.

Étape 2 : mettre à jour vers WSL 2Step 2 - Update to WSL 2

Pour mettre à jour vers WSL 2, vous devez exécuter Windows 10.To update to WSL 2, you must be running Windows 10.

SpécificationsRequirements

  • Pour les systèmes x64 : Version 1903 ou supérieure, avec Build 18362 ou version supérieure.For x64 systems: Version 1903 or higher, with Build 18362 or higher.
  • Pour les systèmes ARM64 : Version 2004 ou supérieure, avec Build 19041 ou version supérieure.For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.
  • Les builds inférieures à 18362 ne prennent pas en charge WSL 2.Builds lower than 18362 do not support WSL 2. Utilisez l’Assistant Windows Update pour mettre à jour votre version de Windows.Use the Windows Update Assistant to update your version of Windows.

Pour vérifier votre numéro de version et de build, sélectionnez la touche Windows + R, tapez winver et sélectionnez OK.To check your version and build number, select Windows logo key + R, type winver, select OK. (Ou entrez la commande ver dans l’invite de commandes Windows).(Or enter the ver command in Windows Command Prompt). Mettez à jour vers la dernière version de Windows via le menu Paramètres.Update to the latest Windows version in the Settings menu.

Notes

Si vous exécutez Windows 10 version 1903 ou 1909, ouvrez « Paramètres » dans le menu Windows, accédez à « Mise à jour et sécurité » et sélectionnez « Rechercher les mises à jour ».If you are running Windows 10 version 1903 or 1909, open "Settings" from your Windows menu, navigate to "Update & Security" and select "Check for Updates". Votre numéro de build doit être 18362.1049+ ou 18363.1049+, avec la build mineure supérieure à .1049.Your Build number must be 18362.1049+ or 18363.1049+, with the minor build # over .1049. En savoir plus : La prise en charge de WSL 2 est disponible dans les versions 1903 et 1909 de Windows 10.Read more: WSL 2 Support is coming to Windows 10 Versions 1903 and 1909. Consultez les instructions de résolution des problèmes.See the troubleshooting instructions.

Étape 3 : activer la fonctionnalité Machine virtuelleStep 3 - Enable Virtual Machine feature

Avant d’installer WSL 2, vous devez activer la fonctionnalité facultative Plateforme de machine virtuelle.Before installing WSL 2, you must enable the Virtual Machine Platform optional feature.

Ouvrez PowerShell en tant qu’administrateur et exécutez :Open PowerShell as Administrator and run:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Redémarrez votre ordinateur pour terminer l’installation de WSL et mettre à jour vers WSL 2.Restart your machine to complete the WSL install and update to WSL 2.

Étape 4 : télécharger le package de mise à jour du noyau LinuxStep 4 - Download the Linux kernel update package

  1. Téléchargez le dernier package :Download the latest package:

    Notes

    Si vous utilisez une machine ARM64, téléchargez le package ARM64 à la place.If you're using an ARM64 machine, please download the ARM64 package instead. Si vous n’êtes pas sûr du type de machine que vous avez, ouvrez l’invite de commandes ou PowerShell et entrez : systeminfo | find "System Type".If you're not sure what kind of machine you have, open Command Prompt or PowerShell and enter: systeminfo | find "System Type".

  2. Exécutez le package de mise à jour téléchargé à l’étape précédente.Run the update package downloaded in the previous step. (Double-cliquez pour exécuter. Des autorisations élevées vous sont demandées, sélectionnez « Oui » pour approuver cette installation.)(Double-click to run - you will be prompted for elevated permissions, select ‘yes’ to approve this installation.)

Lorsque l’installation est terminée, passez à l’étape suivante : définition de WSL 2 comme version par défaut lors de l’installation de nouvelles distributions Linux.Once the installation is complete, move on to the next step - setting WSL 2 as your default version when installing new Linux distributions. (Ignorez cette étape si vous souhaitez que vos nouvelles installations Linux soient définies sur WSL 1).(Skip this step if you want your new Linux installs to be set to WSL 1).

Notes

Pour plus d’informations, consultez l’article sur les changements apportés à la mise à jour du noyau Linux WSL2, disponible sur le blog de la ligne de commande Windows.For more information, read the article changes to updating the WSL2 Linux kernel, available on the Windows Command Line Blog.

Étape 5 : définir WSL 2 comme version par défautStep 5 - Set WSL 2 as your default version

Ouvrez PowerShell et exécutez cette commande pour définir WSL 2 comme version par défaut lors de l’installation d’une nouvelle distribution Linux :Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

Notes

L’exécution de la mise à jour de WSL 1 vers WSL 2 peut prendre plusieurs minutes en fonction de la taille de votre distribution ciblée.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Si vous exécutez une ancienne installation (héritée) de WSL 1 à partir de Windows 10 version Mise à jour anniversaire ou Creators Update, une erreur de mise à jour peut se produire.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Suivez ces instructions pour désinstaller et supprimer les distributions héritées.Follow these instructions to uninstall and remove any legacy distributions.

Si wsl --set-default-version est considéré comme une commande non valide, entrez wsl --help.If wsl --set-default-version results as an invalid command, enter wsl --help. Si --set-default-version ne figure pas dans la liste, cela signifie que votre système d’exploitation ne le prend pas en charge et que vous devez effectuer une mise à jour vers la version 1903, build 18362 ou ultérieure.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 1903, Build 18362 or higher.

Si ce message s’affiche après l’exécution de la commande suivante : WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel.If you see this message after running the command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Vous devez toujours installer le package de mise à jour du noyau MSI Linux.You still need to install the MSI Linux kernel update package.

Étape 6 : installer la distribution Linux de votre choixStep 6 - Install your Linux distribution of choice

  1. Ouvrez le Microsoft Store et sélectionnez votre distribution Linux préférée.Open the Microsoft Store and select your favorite Linux distribution.

    Vue des distributions Linux dans le Microsoft Store

    Les liens suivants ouvrent la page Microsoft Store pour chaque distribution :The following links will open the Microsoft store page for each distribution:

  2. Dans la page de la distribution, sélectionnez « Obtenir ».From the distribution's page, select "Get".

    Distributions Linux dans le Microsoft Store

Étape 7 : configurer une nouvelle distributionStep 7 - Set up a new distribution

La première fois que vous lancez une distribution Linux nouvellement installée, une fenêtre de console s’ouvre et vous êtes invité à attendre une minute ou deux pour que les fichiers soient décompressés et stockés sur votre PC.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Tous les lancements ultérieurs doivent prendre moins d’une seconde.All future launches should take less than a second.

Vous devez ensuite créer un compte d’utilisateur et un mot de passe pour votre nouvelle distribution Linux.You will then need to create a user account and password for your new Linux distribution.

Décompression Ubuntu dans la console Windows

FÉLICITATIONS ! Vous avez correctement installé et configuré une distribution Linux entièrement intégrée à votre système d’exploitation Windows !CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

Installer le Terminal Windows (facultatif)Install Windows Terminal (optional)

Le Terminal Windows permet d’activer plusieurs onglets (basculement rapide d’une ligne de commande Linux à l’autre, invite de commandes Windows, PowerShell, Azure CLI, etc.), de créer des combinaisons de touches personnalisées (touches de raccourci pour ouvrir ou fermer les onglets, Copier + Coller, etc.), d’utiliser la fonctionnalité de recherche et de configurer des thèmes personnalisés (modèles de couleurs, styles et tailles de police, image d’arrière-plan/flou/transparence).Windows Terminal enables multiple tabs (quickly switch between multiple Linux command lines, Windows Command Prompt, PowerShell, Azure CLI, etc), create custom key bindings (shortcut keys for opening or closing tabs, copy+paste, etc.), use the search feature, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). En savoir plus.Learn more.

Installer le Terminal Windows.Install Windows Terminal.

Terminal Windows

Définir votre version de distribution sur WSL 1 ou WSL 2Set your distribution version to WSL 1 or WSL 2

Vous pouvez vérifier la version WSL affectée à chacune des distributions Linux que vous avez installées en ouvrant la ligne de commande PowerShell et en entrant la commande (disponible uniquement dans la build Windows 18362 ou ultérieure) : wsl -l -vYou can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18362 or higher): wsl -l -v

wsl --list --verbose

Pour définir une distribution devant reposer sur l’une ou l’autre des versions WSL, exécutez :To set a distribution to be backed by either version of WSL please run:

wsl --set-version <distribution name> <versionNumber>

Veillez à remplacer <distribution name> par le vrai nom de votre distribution et <versionNumber> par le chiffre « 1 » ou « 2 ».Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. Vous pouvez revenir à WSL 1 quand vous voulez en exécutant la même commande que ci-dessus, mais en remplaçant le « 2 » par un « 1 ».You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Par ailleurs, si vous souhaitez faire de WSL 2 votre architecture par défaut, utilisez cette commande :Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

Cela permet de définir la version de toute nouvelle distribution installée sur WSL 2.This will set the version of any new distribution installed to WSL 2.

Résolution des problèmes liés à l’installationTroubleshooting installation

Vous trouverez ci-dessous des erreurs associées et des suggestions de correction.Below are related errors and suggested fixes. Reportez-vous à la page de résolution des problèmes WSL pour voir des erreurs courantes et leurs solutions.Refer to the WSL troubleshooting page for other common errors and their solutions.

  • Échec de l’installation avec l’erreur 0x80070003Installation failed with error 0x80070003

    • Le sous-système Windows pour Linux s’exécute uniquement sur votre lecteur système (en général, il s’agit de votre lecteur C:).The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Vérifiez que les distributions sont stockées sur votre lecteur système :Make sure that distributions are stored on your system drive:
    • Ouvrez Paramètres -> **Système --> Stockage -> Autres paramètres de stockage : Modifier l’emplacement d’enregistrement du nouveau contenu Image des paramètres système pour installer les applications sur le lecteur C:Open Settings -> **System --> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • Échec de WslRegisterDistribution avec l’erreur 0x8007019eWslRegisterDistribution failed with error 0x8007019e

    • Le composant facultatif Sous-système Windows pour Linux n’est pas activé :The Windows Subsystem for Linux optional component is not enabled:
    • Ouvrez Panneau de configuration -> Programmes et fonctionnalités -> Activer ou désactiver des fonctionnalités Windows -> Cochez Sous-système Windows pour Linux ou utilisez l’applet de commande PowerShell mentionnée au début de cet article.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • Échec de l’installation avec l’erreur 0x80070003 ou l’erreur 0x80370102Installation failed with error 0x80070003 or error 0x80370102

    • Assurez-vous que la virtualisation est activée dans le BIOS de votre ordinateur.Please make sure that virtualization is enabled inside of your computer's BIOS. Les instructions sur la façon de procéder varient d’un ordinateur à l’autre et se trouvent très probablement sous les options liées au processeur.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • Erreur lors d’une tentative de mise à niveau : Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Vérifiez que le sous-système Windows pour Linux est activé et que vous utilisez la version de build 18362 ou ultérieure de Windows.Enure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18362 or higher. Pour activer WSL, exécutez cette commande dans une invite PowerShell avec des privilèges d’administrateur : Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a PowerShell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.
  • Impossible de terminer l’opération demandée du fait d’une limitation du système de disque virtuel. Les fichiers de disque dur virtuel doivent être décompressés et déchiffrés, mais ne doivent pas être partiellement alloués.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.

    • Désélectionnez « Compresser le contenu » (ainsi que « Chiffrer le contenu » si coché) en ouvrant le dossier de profil pour votre distribution Linux.Deselect “Compress contents” (as well as “Encrypt contents” if that’s checked) by opening the profile folder for your Linux distribution. Il doit se trouver dans un dossier de votre système de fichiers Windows, par exemple : USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...It should be located in a folder on your Windows file system, something like: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
    • Dans ce profil de distribution Linux, il doit y avoir un dossier LocalState.In this Linux distro profile, there should be a LocalState folder. Cliquez avec le bouton droit sur ce dossier pour afficher un menu d’options.Right-click this folder to display a menu of options. Sélectionnez Propriétés > Avancé, puis assurez-vous que les cases à cocher « Compresser le contenu pour économiser l’espace disque » et « Chiffrer le contenu pour sécuriser les données » sont désélectionnées (non cochées).Select Properties > Advanced and then ensure that the “Compress contents to save disk space” and “Encrypt contents to secure data” checkboxes are unselected (not checked). Si vous êtes invité à indiquer si vous souhaitez appliquer ceci juste au dossier actif ou à tous les sous-dossiers et fichiers, sélectionnez « juste ce dossier » parce que vous n’effacez que l’indicateur de compression.If you are asked whether to apply this to just to the current folder or to all subfolders and files, select “just this folder” because you are only clearing the compress flag. Après cela, la commande wsl --set-version devrait fonctionner.After this, the wsl --set-version command should work.

Capture d’écran des paramètres de propriété de distribution WSL

Notes

Dans mon cas, le dossier LocalState pour ma distribution Ubuntu 18.04 se trouvait sur C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgscIn my case, the LocalState folder for my Ubuntu 18.04 distribution was located at C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

Consultez le thread GitHub n° 4103 de la documentation WSL où ce problème est suivi pour obtenir des informations mises à jour.Check WSL Docs GitHub thread #4103 where this issue is being tracked for updated information.

  • Le terme « wsl » n’est pas reconnu comme nom d’applet de commande, fonction, fichier de script ou programme exécutable.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.

  • Error: Cette mise à jour s’applique seulement aux machines avec le sous-système Windows pour Linux.Error: This update only applies to machines with the Windows Subsystem for Linux.

    • Pour installer le package MSI de mise à jour du noyau Linux, WSL est requis et doit être activé en premier.To install the Linux kernel update MSI package, WSL is required and should be enabled first. En cas d’échec, le message suivant s’affiche : This update only applies to machines with the Windows Subsystem for Linux.If it fails, it you will see the message: This update only applies to machines with the Windows Subsystem for Linux.
    • Ce message apparaît pour trois raisons possibles :There are three possible reason you see this message:
    1. Vous êtes toujours dans une ancienne version de Windows qui ne prend pas en charge WSL 2.You are still in old version of Windows which doesn't support WSL 2. Consultez l’étape 2 pour connaître la configuration requise de la version et obtenir des liens de mise à jour.See step #2 for version requirements and links to update.

    2. WSL n’est pas activé.WSL is not enabled. Vous devez revenir à l’étape 1 et vous assurer que la fonctionnalité facultative WSL est activée sur votre machine.You will need to return to step #1 and ensure that the optional WSL feature is enabled on your machine.

    3. Une fois que vous avez activé WSL, un redémarrage est nécessaire pour sa prise en compte : redémarrez votre machine, puis réessayez.After you enabled WSL, a reboot is required for it to take effect, reboot your machine and try again.

  • Error: WSL 2 requiert une mise à jour de son composant noyau. Pour obtenir des informations, consultez https://aka.ms/wsl2kernel .Error: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel .

    • Si le package du noyau Linux est manquant dans le dossier %SystemRoot%\system32\lxss\tools, cette erreur se produit.If the Linux kernel package is missing in the %SystemRoot%\system32\lxss\tools folder, you will encounter this error. Résolvez-la en installant le package MSI de mise à jour du noyau Linux à l’étape 4 de ces instructions d’installation.Resolve it by installing the Linux kernel update MSI package in step #4 of these installation instructions. Vous devrez peut-être désinstaller le MSI dans « Ajouter ou supprimer des programmes », puis le réinstaller.You may need to uninstall the MSI from 'Add or Remove Programs', and install it again.