Try   HackMD

Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More →

Comment installer, sauvegarder et restaurer une instance WSL2

Pourquoi sauvegarder son environnement WSL2 ?

Si tu utilises WSL2 pour bosser sous Linux depuis Windows, tu sais à quel point c’est pratique : tu lances un terminal, et hop, tu as Bash, apt, Docker, Node ou Python dispo sans machine virtuelle. Mais un jour, tu changes de PC, ton instance plante, ou tu veux dupliquer ton environnement sans tout réinstaller.

WSL2 permet justement de tout sauvegarder proprement — système, fichiers, outils — et de restaurer ou cloner ton environnement en quelques lignes de commande.
Ce guide te montre comment :

  • installer WSL2 (méthode classique ou personnalisée),
  • sauvegarder une instance existante,
  • la restaurer ou la dupliquer,
  • supprimer une instance proprement,
  • et éviter les erreurs classiques.

Ce qu’il faut avant de commencer

Avant d’attaquer, assure-toi que ton système est prêt :

Éléments nécessaires OK ?
Windows 10 (version 2004 ou +) ou Windows 11
Accès administrateur
WSL activé
WSL version 2 configurée par défaut
Terminal PowerShell ou CMD

Installer WSL2 (méthode classique)

Étape 1 : activer WSL et installer Ubuntu

Terminal : PowerShell (lancé en tant qu’administrateur)

wsl --install

Cette commande fait tout :

  • installe les composants nécessaires (WSL, machine virtuelle légère),
  • configure WSL2 par défaut,
  • télécharge et installe Ubuntu.

Redémarre si on te le demande.

Étape 2 : lancer Ubuntu pour la première fois

Une fois installé, cherche “Ubuntu” dans ton menu démarrer, et lance-le.

Il va finaliser l’installation et te demander de créer un utilisateur et un mot de passe Linux. Ensuite, tu es prêt à bosser.


Installer une distribution avec un nom personnalisé (méthode avancée)

Tu veux avoir plusieurs instances Ubuntu ? Ou renommer proprement ta VM ? Cette méthode te permet d'importer une distribution Linux depuis une image .tar, avec le nom que tu veux et à l’emplacement de ton choix.

Étapes

Terminal : PowerShell (en tant qu’administrateur)

  1. Télécharge une image .tar officielle
    Va sur : https://cloud-images.ubuntu.com/wsl/
    Télécharge par exemple : ubuntu-jammy-wsl.rootfs.tar.gz
    Renomme-le en .tar si besoin.

  2. Crée un dossier pour héberger l’instance

mkdir D:\WSL\UbuntuPerso
  1. Importe et nomme l’instance
wsl --import UbuntuPerso D:\WSL\UbuntuPerso D:\Install\ubuntu-jammy.tar
  • UbuntuPerso est le nom de l’instance
  • D:\WSL\UbuntuPerso est l’emplacement où seront stockés les fichiers
  • D:\Install\ubuntu-jammy.tar est le fichier téléchargé

Sauvegarder une instance WSL2

À tout moment, tu peux sauvegarder ton instance dans un fichier .tar. Pratique avant une mise à jour ou un changement de machine.

Terminal : PowerShell ou CMD

wsl --export NomInstance Chemin\vers\le\backup.tar

Exemple :

wsl --export UbuntuPerso D:\Backups\ubuntu-perso-backup.tar

Restaurer ou cloner une instance

Tu peux créer une nouvelle instance à partir d’un fichier .tar sauvegardé précédemment.

Terminal : PowerShell (admin recommandé)

wsl --import NouveauNom DossierCible FichierTar

Exemple :

wsl --import UbuntuRestored D:\WSL\UbuntuRestored D:\Backups\ubuntu-perso-backup.tar

Lister toutes les instances WSL installées

Terminal : PowerShell ou CMD

wsl --list --verbose

Tu verras une liste avec l’état (running/stopped), le nom de chaque instance, et la version (1 ou 2).


Supprimer une instance WSL2

Attention, cette commande supprime définitivement l’instance et toutes ses données.

Terminal : PowerShell (admin recommandé)

wsl --unregister NomInstance

Exemple :

wsl --unregister UbuntuRestored

Quelques conseils utiles

  • Sauvegarde régulièrement tes instances, surtout si tu travailles dessus tous les jours.
  • Donne des noms clairs à tes distributions pour ne pas t’y perdre.
  • Ne modifie jamais les fichiers directement dans D:\WSL\..., sauf si tu sais exactement ce que tu fais.
  • Tu peux automatiser les exports avec un script .bat ou .ps1 si tu veux sauvegarder régulièrement.

Avec ces quelques étapes, tu maîtrises l’essentiel pour installer, sauvegarder et restaurer tes environnements sous Windows Subsystem for Linux. Que ce soit pour cloner une instance, en changer le nom ou repartir de zéro, tout se fait rapidement en ligne de commande. Plus besoin de tout reconfigurer à chaque changement de machine.

Si ce guide t’a été utile, n’hésite pas à le partager, et viens faire un tour sur www.alternative-rvb.com pour d’autres tutoriels et ressources dédiés aux développeurs.