Changelog

Update WSA Version From 2311.40000.5.0 to 2407.40000.0.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update KernelSU Version From v0.9.2 to v1.0.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update Magisk Version From 26.4 to 27.0

Update KernelSU Version From v0.7.2 to v0.9.2

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update WSA Version From 2311.40000.4.0 to 2311.40000.5.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update WSA Version From 2311.40000.3.0 to 2311.40000.4.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update WSA Version From 2310.40000.2.0 to 2311.40000.3.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update WSA Version From 2309.40000.10.0 to 2310.40000.2.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update WSA Version From 2309.40000.8.0 to 2309.40000.10.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.

   If the script fails, you can take the following steps for diagnosis (admin privilege required):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

Changelog

Update WSA Version From 2308.40000.4.0 to 2309.40000.8.0

SHA256 Checksum

021f568cc366879295e5d1fd58442028cb46c604daa0345ed77bd2a2bf0580a3 WSA_2309.40000.8.0_arm64_Release-MindTheGapps-13.0.zip
5f646a1e1fdf9ee16fa686fdb5dd57266591977fe1da121eb77566840c713ad5 WSA_2309.40000.8.0_arm64_Release-with-magisk-26.3-MindTheGapps-13.0.zip
1efdcc7249e413d36c786bc56d72a3bc68ae1547b0d90f522a23ee19afd83c74 WSA_2309.40000.8.0_arm64_Release-with-magisk-26.3.zip
7d9e5a10c1f4a660076ebc54c8ade9111e2ba13d972dcd701eb04cb695ecf7f7 WSA_2309.40000.8.0_arm64_Release.zip
9e91702d4a03175eb283573edd879686b74efdb0ab262d2e0830fa81bcacfb11 WSA_2309.40000.8.0_x64_Release-MindTheGapps-13.0.zip
02195c14d9dfbcaab733791819f30d5aea63d6dc45a74e8d5d2a14a4d75d3ede WSA_2309.40000.8.0_x64_Release-with-magisk-26.3-MindTheGapps-13.0.zip
3936a38f3c0846f64eb7307e7b976d3d8702d78279fe4ba305b5127796da706f WSA_2309.40000.8.0_x64_Release-with-magisk-26.3.zip
82be323f7c2ed1810018a444a7da135a3c0bf55cf56f0d6f48c564efc3e57669 WSA_2309.40000.8.0_x64_Release.zip

Changelog

Update WSA Version From 2308.40000.3.0 to 2308.40000.4.0

SHA256 Checksum

5de9b231a72b33f24ec90cfd0221334db235d3522eb6bda2c5a074c1df8a51b7 WSA_2308.40000.4.0_arm64_Release-MindTheGapps-13.0.zip
501b9a0987384252e702b73c989f18423ba49653441747937e7b9ee0b3a9eba9 WSA_2308.40000.4.0_arm64_Release-with-magisk-26.3-MindTheGapps-13.0.zip
92486025048e8ba0ac73624daec8c28e4ccde308a5cddff9b2f7595d765f30c1 WSA_2308.40000.4.0_arm64_Release-with-magisk-26.3.zip
f10d4bb22ff459aae581a7f2b3ce8168626fe95a3ef9bc1c5e3fc7502cdab865 WSA_2308.40000.4.0_arm64_Release.zip
296165b99439d4e7ff8d124bfc4d96506b755d8d40af5afcf45846e83f382073 WSA_2308.40000.4.0_x64_Release-MindTheGapps-13.0.zip
b079738b28e93a9ba05d57513f6b5fa25809215c761cadcfa186976257808f5f WSA_2308.40000.4.0_x64_Release-with-magisk-26.3-MindTheGapps-13.0.zip
33b544e451681c48df36d6ea0fc3370802db90dd37a8ab6f50357df0edd56aa2 WSA_2308.40000.4.0_x64_Release-with-magisk-26.3.zip
b170a9a022e2271f5b8f7b2390e559ca13f182ea81b628537006fce26be2a2b4 WSA_2308.40000.4.0_x64_Release.zip