---
# System prepended metadata

title: 'Installer, sauvegarder et restaurer une instance WSL2'
tags: [Bash, WSL2, ' Windows', ' WSL']

---

![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.


