Install Magisk on WSA with Google Apps (Windows Subsystem for Android)

Integrate Magisk root and Google Apps (OpenGApps) into WSA (Windows Subsystem for Android)

Contents show

Features

  • Integrate Magisk and OpenGApps in a few clicks within minutes
  • No Linux environment required for integration
  • Keep each build up to date
  • Support both ARM64 and x64
  • Support all OpenGApps variants except for aroma (aroma does not support x86_64, please use super instead)
  • Fix external storage access of DocumentUI
  • Unattended installation
  • Automatically activates developers mode in Windows 11
  • Update to new version while preserving data with one-click script
  • Merged all language packs

How to install Magisk on Windows Subsystem for Android

Video Guide

Text Guide

  1. Star (if you like) and fork this repo
  2. Go to the Action tab in your forked repo.
  3. In the left sidebar, click the Build WSA workflow.
  4. Above the list of workflow runs, select Run workflow.
  5. Input the download link of Magisk and select the OpenGApps variant (none is no OpenGApps) you like, select the root solution (none means no root) and click Run workflow.
  6. Wait for the action to complete and download the artifact.
  7. Unzip the artifactThe size shown in the webpage is uncompressed size and the zip you download will be compressed. So the size of the zip will be much less than the size shown in the webpage.
  8. Right-click Install.ps1 and select Run with PowerShellIf you previously have a MagiskOnWSA installation, it will automatically uninstall the previous while preserving all userdata and install the new one, so don’t worry about your data.
  9. If you have an official WSA installation, you should uninstall it first. (In case you want to preserve your data, you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation.) (If you want to restore the icons to start menu, please install and use WSAHelper.)
  10. If the popup windows disappear without asking administrative permission and WSA is not installed successfully, you should manually run Install.ps1 as administrator:Press Win+x and select Windows Terminal (Admin)
  11. Input cd "{X:\path\to\your\extracted\folder}" and press enter, and remember to replace {X:\path\to\your\extracted\folder} including the {}, for example cd "D:\wsa"
  12. Input PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1 and press enter
  13. The script will run and WSA will be installed
  14. If this workaround does not work, your PC is not supported for WSA
  15. Magisk/Play store will be launched. Enjoy by installing LSPosed-zygisk with zygisk enabled or Riru and LSPosed-riru.

FAQ

  • Can I delete the unzipped folder?
    No.
  • Why the size of the zip does not match the one shown?
    The zip you downloaded is compressed and Github is showing the uncompressed size.
  • How can I update WSA to new version?
    Rerun the Github action, download the new artifact, replace the content of your previous installation and rerun Install.ps1. Don’t worry, your data will be preserved.
  • How can I get the logcat from WSA?
    %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat
  • How can I update Magisk to new version?
    Do the same as updating WSA
  • VPN is not working?
    Tell Microsoft to fix it. We cannot fix it easily.
  • How to pass safetynet?
    Like all the other emulators, no way.
  • Virtualization is not enabled?
    Install.ps1 helps you enable it if not enabled. After rebooting, rerun Install.ps1 to install WSA. If it’s still not working, you have to enable virtualization in BIOS. That’s a long story so ask Google for help.
  • How to remount system as read-write?
    No way in WSA since it’s mounted as read-only by Hyper-V. You can modify system by making a Magisk module. Or directly modify system.img. Ask Google for help.
  • I cannot adb connect localhost:58526
    Make sure developer mode is enabled. If the issue persists, check the IP address of WSA in the setting page and try adb connect ip:5555.
  • Magisk online module list is empty?
    Magisk actively remove online module repository. You can install module locally or by adb push module.zip /data/local/tmp and adb shell su -c magisk --install-module /data/local/tmp/module.zip.
  • Can I use Magisk 23.0 stable or lower version?
    No. Magisk has bugs preventing itself running on WSA. Magisk Canary has fixed them. So try Magisk 23 canary or higher version.
  • But Magisk has removed hide since 23 canary?
    Use Magisk Alpha or use Zygisk with Shamiko for hidding. To intergrate Magisk Alpha, use this Magisk apk link https://github.com/vvb2060/magisk_files/raw/alpha/app-release.apk for the Github Action.
  • How can I get rid of Magisk?Input none as root solution.
    Can I delete the unzipped folder?
    No.
  • Why the size of the zip does not match the one shown?
    The zip you downloaded is compressed and Github is showing the uncompressed size.
  • How can I update WSA to new version?
    Rerun the Github action, download the new artifact, replace the content of your previous installation and rerun Install.ps1. Don’t worry, your data will be preserved.
  • How can I get the logcat from WSA?
    %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat
  • How can I update Magisk to new version?
    Do the same as updating WSA
  • VPN is not working?
    Tell Microsoft to fix it. We cannot fix it easily.
  • How to pass safetynet?
    Like all the other emulators, no way.
  • Virtualization is not enabled?
    Install.ps1 helps you enable it if not enabled. After rebooting, rerun Install.ps1 to install WSA. If it’s still not working, you have to enable virtualization in BIOS. That’s a long story so ask Google for help.
  • How to remount system as read-write?
    No way in WSA since it’s mounted as read-only by Hyper-V. You can modify system by making a Magisk module. Or directly modify system.img. Ask Google for help.
  • I cannot adb connect localhost:58526
    Make sure developer mode is enabled. If the issue persists, check the IP address of WSA in the setting page and try adb connect ip:5555.
  • Magisk online module list is empty?
    Magisk actively remove online module repository. You can install module locally or by adb push module.zip /data/local/tmp and adb shell su -c magisk --install-module /data/local/tmp/module.zip.
  • Can I use Magisk 23.0 stable or lower version?
    No. Magisk has bugs preventing itself running on WSA. Magisk Canary has fixed them. So try Magisk 23 canary or higher version.
  • But Magisk has removed hide since 23 canary?
    Use Magisk Alpha or use Zygisk with Shamiko for hidding. To intergrate Magisk Alpha, use this Magisk apk link https://github.com/vvb2060/magisk_files/raw/alpha/app-release.apk for the Github Action.
  • How can I get rid of Magisk?
    Input none as root solution.