Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lpcodes/moving-wsl-distribution-to-another-drive

This guide provides step-by-step instructions on how to move a Linux distribution installed on Windows Subsystem for Linux (WSL) to a different drive.
https://github.com/lpcodes/moving-wsl-distribution-to-another-drive

linux ubuntu windows-11 wsl

Last synced: 1 day ago
JSON representation

This guide provides step-by-step instructions on how to move a Linux distribution installed on Windows Subsystem for Linux (WSL) to a different drive.

Awesome Lists containing this project

README 

        

# 📦 Moving WSL Distribution to Another Drive



🚀 This guide explains the process of moving a Linux distribution installed on Windows Subsystem for Linux (WSL) to another drive. In this example, we will be moving an Ubuntu 22.04 distribution, and the steps are outlined below.



## 🛠️ Prerequisites



- Windows operating system with WSL 2 installed.



## 📋 Instructions



1. Check the existing WSL 2 installations on your computer by running the following command in a WSL or Command Prompt window:



   ```bash

   wsl --list -v

   ```



   If the installation you want to move is currently running, you need to stop it. For example, if you want to move Ubuntu 22.04, terminate it using the following command:



   ```bash

   wsl -t Ubuntu-22.04

   ```



2. Export the WSL distribution to a folder. In this example, we will export Ubuntu 22.04 as `ubuntu-ex.tar` to the `D:\wsl_export` directory. Run the following command:



   ```bash

   wsl --export Ubuntu-22.04 "D:\wsl_export\ubuntu-ex.tar"

   ```



3. Unregister the previous WSL installation. This step removes the Ubuntu 22.04 distribution from the WSL 2 list obtained in the previous step. Execute the following command:



   ```bash

   wsl --unregister Ubuntu-22.04

   ```



4. Import the WSL installation to a new folder and re-register it. In this example, we will import Ubuntu 22.04 to the `D:\wsl_import\ubuntu` directory using the exported `ubuntu-ex.tar` file. Run the following command:



   ```bash

   wsl --import Ubuntu-22.04 "D:\wsl_import\ubuntu" "D:\wsl_export\ubuntu-ex.tar"

   ```



5. Set default user (optional): This step is only necessary if you're:

   - Importing to a new machine or creating a new user for Ubuntu. Setting the default user avoids login prompts each time you launch the distribution.

   - Using multiple users on your Windows machine and want different defaults for each. This clarifies which user launches by default for each WSL environment.



   To set the default user, run: `.exe config --default-user me` (replace "me" with your actual username).



   For instance, if you installed "Ubuntu 22.04" from the Store, you would use:



   ```bash

   ubuntu2204.exe config --default-user me

   ```



   The .exe here is an "App Execution Alias" in Windows. You can check the name by going to "Manage app execution aliases" in the Windows System Settings.



6. Set default distribution (optional): This step is necessary only if you have multiple distributions registered in WSL and you want to use the imported one as the default.



   To set the default distribution, run `wsl --setdefault `, e.g., `wsl --setdefault Ubuntu-22.04`

   

🎉 Congratulations! You have successfully moved your WSL distribution (Ubuntu 22.04) to another drive. You can now start the distribution and continue using it at the new location.



🛠️ Don't hesitate to create pull requests if you have suggestions for improvements to this guide. Your contributions are greatly appreciated!