Geo : Page créée avec « '''backup/restore image WSL2''' ----- == 📋 Vérifier les distributions installées == Liste les distributions et leur version WSL (1 ou 2) : wsl -l -v Exemple de sortie :

  NAME      STATE           VERSION * Debian    Running         2   Ubuntu    Stopped         2

L’astérisque * indique la distro par défaut pour wsl (si tu ne passes pas -d <... »


2026-01-08T09:06:00Z
Page créée avec « '''backup/restore image WSL2''' -----  == 📋 Vérifier les distributions installées ==  Liste les distributions et leur version WSL (1 ou 2) :  <syntaxhighlight lang="powershell">wsl -l -v</syntaxhighlight> Exemple de sortie :  <pre>  NAME      STATE           VERSION * Debian    Running         2   Ubuntu    Stopped         2</pre> <blockquote>L’astérisque <code>*</code> indique la distro par défaut pour <code>wsl</code> (si tu ne passes pas <code>-d <... »
Nouvelle page
'''backup/restore image WSL2'''

-----



== 📋 Vérifier les distributions installées ==



Liste les distributions et leur version WSL (1 ou 2) :



<syntaxhighlight lang="powershell">wsl -l -v</syntaxhighlight>

Exemple de sortie :



<pre>  NAME      STATE           VERSION

* Debian    Running         2

  Ubuntu    Stopped         2</pre>

<blockquote>L’astérisque <code>*</code> indique la distro par défaut pour <code>wsl</code> (si tu ne passes pas <code>-d &lt;name&gt;</code>).

</blockquote>



-----



== 🧯 Arrêter proprement avant un backup ==



Pour un export fiable, il est recommandé d’arrêter la distribution :



<syntaxhighlight lang="powershell">wsl --terminate debian</syntaxhighlight>

<blockquote><code>--terminate</code> ferme toutes les sessions de la distro.<br />

Tu peux vérifier que c’est bien stoppé avec <code>wsl -l -v</code>.

</blockquote>



-----



== 💾 Backup (export) ==



Format recommandé (tar) :



<syntaxhighlight lang="powershell">wsl --export debian D:\Backups\debian_backup_2025-01-08.tar</syntaxhighlight>

* <code>debian</code> = nom de la distribution (depuis <code>wsl -l -v</code>)

* <code>D:\Backups\...tar</code> = fichier d’archive créé (rootfs + metadata)



<blockquote>Tu peux compresser le <code>.tar</code> après coup (7zip), mais '''l’import attend un <code>.tar</code>''' (ou <code>.vhdx</code> si tu importes via VHDX, voir plus bas Astuces).

</blockquote>



-----



== 🔁 Restore (import) dans une '''nouvelle''' distro ==



Si tu veux restaurer '''sans toucher''' la distro existante, importe sous un nouveau nom :



<syntaxhighlight lang="powershell">wsl --import debian_restored D:\WSL\debian_restored D:\Backups\debian_backup_2025-01-08.tar</syntaxhighlight>

* <code>debian_restored</code> = nom de la '''nouvelle''' distro WSL

* <code>D:\WSL\debian_restored</code> = dossier où WSL stocke le VHDX

* <code>D:\Backups\debian_backup_2025-01-08.tar</code> = backup réalisé plus haut



Ensuite, force en WSL2 si nécessaire :



<syntaxhighlight lang="powershell">wsl --set-version debian_restored 2</syntaxhighlight>



-----



== 🗑️ Restore '''par-dessus''' une distro existante (même nom) ==



<blockquote>⚠️ '''Destructif''' : supprime totalement la distribution et son disque.

</blockquote>

# Arrête la distro :



<syntaxhighlight lang="powershell">wsl --terminate debian</syntaxhighlight>

<ol start="2" style="list-style-type: decimal;">

<li>'''Supprime''' la distro :</li></ol>



<syntaxhighlight lang="powershell">wsl --unregister debian</syntaxhighlight>

<ol start="3" style="list-style-type: decimal;">

<li>Réimporte '''avec le même nom''' :</li></ol>



<syntaxhighlight lang="powershell">wsl --import debian D:\WSL\debian D:\Backups\debian_backup_2025-01-08.tar

wsl --set-version debian 2</syntaxhighlight>



-----



== 👤 Définir l’utilisateur par défaut après import ==



Selon la distribution, l’import crée parfois un environnement où l’utilisateur par défaut est <code>root</code>.<br />

Tu peux fixer un utilisateur par défaut via '''wsl.conf''' :



Dans la distro importée :



<syntaxhighlight lang="bash">sudo nano /etc/wsl.conf</syntaxhighlight>

Ajoute (ou modifie) :



<syntaxhighlight lang="ini">[user]

default=john</syntaxhighlight>

Puis '''redémarre''' la distro :



<syntaxhighlight lang="powershell">wsl --terminate debian_restored</syntaxhighlight>

<blockquote>Pour certaines distros (Ubuntu de Microsoft Store), il existe aussi une commande spécifique :<br />

<code>ubuntu config --default-user &lt;user&gt;</code> (ne s’applique pas aux imports génériques).

</blockquote>



-----



== 🧭 Chemins utiles (accès croisé Windows ⇄ Linux) ==



* '''Depuis Windows vers Linux''' : <code>\\wsl$\Debian\home\john</code>

* '''Depuis Linux vers Windows''' : <code>cd /mnt/c/Users/&lt;username&gt;/Downloads</code>



<blockquote>Évite de travailler sur des projets '''Linux''' directement dans <code>/mnt/c/...</code> (performances et permissions). Préfère un dossier dans <code>~/</code> côté Linux.

</blockquote>



-----



== 🧪 Démarrer/Tester une distro restaurée ==



Démarrer un shell sur la distro importée :



<syntaxhighlight lang="powershell">wsl -d debian_restored</syntaxhighlight>

Vérifier systemd (si tu l’utilises) :



<syntaxhighlight lang="bash">systemctl --version</syntaxhighlight>

<blockquote>Si systemd n’est pas actif, vérifie <code>wsl.conf</code> côté Windows (fichier <code>%userprofile%\.wslconfig</code>) ou côté distro <code>/etc/wsl.conf</code> :

</blockquote>

<syntaxhighlight lang="ini">[boot]

systemd=true</syntaxhighlight>

Puis redémarre WSL :



<syntaxhighlight lang="powershell">wsl --shutdown</syntaxhighlight>



-----



== ⚙️ Paramètres WSL côté Windows (optionnel) ==



Fichier : <code>%UserProfile%\.wslconfig</code><br />

Exemple minimal :



<syntaxhighlight lang="ini">[wsl2]

memory=8GB

processors=4

localhostForwarding=true</syntaxhighlight>

<blockquote>Ajuste pour limiter l’usage RAM/CPU de WSL2.

</blockquote>



-----



== 🧠 Astuces &amp; bonnes pratiques ==



* '''Nommer et dater''' tes backups : <code>debian_backup_YYYY-MM-DD.tar</code>

* '''Arrêter la distro''' avant export : <code>wsl --terminate &lt;name&gt;</code>

* '''Stockage''' : utilise un disque '''NTFS''' local (évite les lecteurs réseau pour l’import/export).

* '''Vérifier la version''' après import : <code>wsl -l -v</code> puis <code>wsl --set-version &lt;name&gt; 2</code>

* '''Import VHDX''' (scénario avancé) : si tu disposes d’un VHDX, tu peux créer une distro avec : <code>powershell     wsl --import &lt;name&gt; &lt;install_path&gt; &lt;rootfs.tar&gt;</code> &gt; WSL crée lui-même le VHDX à partir du <code>.tar</code>. L’import direct d’un VHDX se fait plutôt via '''montage manuel''' ou outils Hyper-V, ce n’est pas l’usage standard recommandé par WSL.

* '''Sauvegarde avant upgrade''' : exporte toujours avant de modifier la distro ou faire un <code>dist-upgrade</code>.

* '''Restauration sur une autre machine''' : assure-toi de la même version WSL (Windows 10/11 à jour) et vérifie <code>wsl --status</code>.





-----



== 🧾 Résumé minimal à mettre dans ta doc ==



'''Lister et arrêter''' :



<syntaxhighlight lang="powershell">wsl -l -v

wsl --terminate debian</syntaxhighlight>

'''Backup''' :



<syntaxhighlight lang="powershell">wsl --export debian D:\Backups\debian_backup.tar</syntaxhighlight>

'''Restore (nouvelle distro)''' :



<syntaxhighlight lang="powershell">wsl --import debian_restored D:\WSL\debian_restored D:\Backups\debian_backup.tar

wsl --set-version debian_restored 2</syntaxhighlight>

'''Restore sur le même nom (destructif)''' :



<syntaxhighlight lang="powershell">wsl --terminate debian

wsl --unregister debian

wsl --import debian D:\WSL\debian D:\Backups\debian_backup.tar

wsl --set-version debian 2</syntaxhighlight>

'''Utilisateur par défaut''' :



<syntaxhighlight lang="ini"># /etc/wsl.conf

[user]

default=john</syntaxhighlight>



-----



[[Catégorie:WSL2]]

WSL backup restore image - Historique des versions