Skip to main content
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.
If you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup Userdata.vhdx before uninstallation and restore it after installation. See the Backup and Restore guide for details.Backup location: %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx

​
Installation Steps

1

Download WSABuilds

Go to the Releases page and download the Windows Subsystem For Android™ version of your choosing from the Assets section.Do not download “Source code” - only download the .7z archive files.
2

Extract and prepare folder

  1. Extract the .7z archive
  2. Rename the extracted folder to WSA
  3. Delete the .7z archive
  4. Move the folder to a suitable location (Documents folder is recommended)
You must keep this folder on your PC to use MagiskOnWSA. Do not delete it after installation.
If you’re updating WSA, merge the folders and replace the files for all items when asked.
3

Run the installer

Open the Windows Subsystem For Android™ folder and double-click Run.bat.
  • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data
  • The script handles installation automatically with administrator privileges
4

Complete installation

  1. Once installation completes, Windows Subsystem For Android™ will launch
  2. On first-time install, a consent window for diagnostic information will appear
  3. Click OK (sometimes two identical windows show - this is normal)
  4. Click on the PowerShell window and press any key to close it
  5. Close File Explorer

​
Manual Installation (If Run.bat Fails)

If the popup windows disappear without asking for administrative permission and WSA is not installed successfully, manually run the installation script:
1

Open Windows Terminal as Administrator

Press Win+X and select Windows Terminal (Admin)
2

Navigate to WSA folder

Replace {X:\path\to\your\extracted\folder} with your actual folder path:
cd "{X:\path\to\your\extracted\folder}"
3

Run the installation script

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 may not be supported for WSA.

​
What the Installer Does

The Install.ps1 script performs these operations:
  1. Checks administrator privileges - Automatically elevates to admin if needed
  2. Validates files - Ensures all required files are present
  3. Enables developer mode - Registers development license in Windows registry: 
    reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
  4. Enables Virtual Machine Platform - Checks and enables if not already active: 
    Enable-WindowsOptionalFeature -Online -NoRestart -FeatureName 'VirtualMachinePlatform'
  5. Installs dependencies - Checks and installs required dependency packages
  6. Removes conflicting installations - Prompts to uninstall official WSA if detected
  7. Registers the AppX package: 
    Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml
  8. Launches WSA apps - Opens Magisk and Google Play Store after successful installation

​
Important Notes

You cannot delete the WSA installation folderThe Add-AppxPackage -Register .\AppxManifest.xml command registers an appx package with unpackaged files. You need to keep these files as long as you want to use Windows Subsystem For Android™.See Microsoft documentation for details.

​
System Requirements

  • Windows 10 (22H2 or later) or Windows 11
  • Virtual Machine Platform feature enabled
  • Administrator access
  • At least 8GB RAM recommended
  • 10GB free disk space minimum

​
Troubleshooting Failed Installation

If the installation fails, follow these diagnostic steps:
1

Open PowerShell as Administrator

Navigate to your Windows Subsystem For Android™ directory
2

Attempt manual registration

This should fail with an ActivityID (UUID) needed for the next step:
Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml
3

Check the error log

Replace <uuid> with the ActivityID from the previous step:
Get-AppPackageLog -ActivityID <uuid>
4

Fix the issue

Check the log for the reason of failure and address it accordingly

​
Next Steps

Update WSA

Learn how to update to newer builds

Backup Your Data

Protect your apps and settings

Install Apps

Start installing Android apps

Configure Magisk

Set up root access and modules

Build docs developers (and LLMs) love

Get started for freeTalk to us