![WSL2](https://hackmd.io/_uploads/rkD-0FLexg.jpg) # 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)** ```powershell 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/](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** ```powershell mkdir D:\WSL\UbuntuPerso ``` 3. **Importe et nomme l’instance** ```powershell 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** ```powershell wsl --export NomInstance Chemin\vers\le\backup.tar ``` **Exemple :** ```powershell 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é)** ```powershell wsl --import NouveauNom DossierCible FichierTar ``` **Exemple :** ```powershell wsl --import UbuntuRestored D:\WSL\UbuntuRestored D:\Backups\ubuntu-perso-backup.tar ``` --- ## Lister toutes les instances WSL installées **Terminal : PowerShell ou CMD** ```powershell 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é)** ```powershell wsl --unregister NomInstance ``` **Exemple :** ```powershell 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](https://www.alternative-rvb.com) pour d’autres tutoriels et ressources dédiés aux développeurs.