Frequently Asked Questions
Installation & Updates
Can I delete the installed folder after installation?
Can I delete the installed folder after installation?
No. The installed folder contains the WSA system files and is required for WSA to run. Deleting it will break your installation.
How can I update Windows Subsystem For Android to a new version?
How can I update Windows Subsystem For Android to a new version?
Download the latest Windows Subsystem For Android Version from the releases page and replace the content of your previous installation, then rerun
Install.ps1.Your data will be preserved during the update process.How do I update Magisk?
How do I update Magisk?
Wait for a new WSABuilds release that includes the newer Magisk version, then follow the installation instructions to update. Magisk cannot be updated independently from the WSA build.
Can I switch between OpenGApps and MindTheGapps?
Can I switch between OpenGApps and MindTheGapps?
No. Switching between different GApps packages will break functionality. You must do a complete uninstallation before switching to a different GApps variant.
Troubleshooting
I am having problems with the WSABuilds - where can I get help?
I am having problems with the WSABuilds - where can I get help?
- Open an issue on GitHub with sufficient detail
- Join the Discord for community support
- Check the troubleshooting guides for common issues
Help me, I am having problems installing WSA on Windows 10
Help me, I am having problems installing WSA on Windows 10
WSA on Windows 10 requires the WSAPatch project. Open an issue in the Discord or GitHub for assistance.For full support with Windows 10 installation, visit the WSAPatch project.
What is virtualization and why do I need it?
What is virtualization and why do I need it?
Virtualization is required to run virtual machines like Windows Subsystem For Android.If virtualization is not enabled:
- Run
Run.batwhich will help you enable it - Reboot your computer
- Re-run
Run.batto install WSA
Features & Capabilities
Can I pass SafetyNet/Play Integrity?
Can I pass SafetyNet/Play Integrity?
No. Virtual machines like Windows Subsystem For Android cannot pass these mechanisms on their own due to the lack of signing by Google.Passing requires more exotic and untested solutions. See: https://github.com/kdrag0n/safetynet-fix/discussions/145#discussioncomment-2170917
Can I remount system partition as read-write?
Can I remount system partition as read-write?
No. WSA is mounted as read-only by Hyper-V. However, you can modify the system partition by:
- Creating a Magisk module
- Directly modifying the
system.imgfile
How do I get a logcat?
How do I get a logcat?
There are two ways to get logs:Method 1 - ADB Command:Method 2 - Log File Location:
ADB & Development
I cannot adb connect localhost:58526
I cannot adb connect localhost:58526
- Make sure developer mode is enabled in WSA Settings
- If the issue persists, check the IP address on the WSA Settings → Developer page
- Try connecting with:
Magisk online module list is empty - how do I install modules?
Magisk online module list is empty - how do I install modules?
Magisk actively removed the online module repository. You must install modules locally:Step 1: Push the module to the deviceStep 2: Install via shell
How do I uninstall Magisk?
How do I uninstall Magisk?
Request a Windows Subsystem For Android version without Magisk from the Releases page using the Issues page.Then follow the installation instructions to switch to a non-Magisk build.
Custom Builds
How do I install custom Magisk or GApps?
How do I install custom Magisk or GApps?
Option 1: Request a custom build by opening an issue on the Issues pageOption 2: Build it yourself using the MagiskOnWSALocal script and following the instructions in that repository.
Need More Help?
Join the Discord Community
Get real-time support from the community and developers