MagiskOnWSALocal README

The project's README from github.com/LSPosed/MagiskOnWSALocal. As one markdown file: README.md.

Magisk on WSA (with Google Apps)

:warning: Magisk on WSA will no longer be available after March 5, 2025. Learn more.

:warning: For fork developers: Please don't build using GitHub Actions, as GitHub will count your forked GitHub Actions usage against this upstream repository, which may cause this upstream repository gets disabled by GitHub staff like MagiskOnWSA because of numerous forks building GitHub Actions, and counting the forks' Action usage against this upstream repository.

Support for generating from these systems

Features

Text Guide

  1. Star (if you like).

  2. Clone the repo to local:

    git clone https://github.com/LSPosed/MagiskOnWSALocal.git --depth 1

  3. Run cd MagiskOnWSALocal.

  4. Run ./scripts/run.sh.

  5. Select the WSA version and its architecture (mostly x64).

  6. Select the version of Magisk.

  7. Choose which brand of GApps you want to install:

    • MindTheGapps

      There is no other variant we can choose.

  8. Select the root solution (none means no root).

  9. If you are running the script for the first time, it will take some time to complete. After the script completes, two new folders named output and download will be generated in the MagiskOnWSALocal folder. Go to the output folder. While running the ./run.sh script in the step 3, if you selected Yes for Do you want to compress the output? then in output folder you will see a compressed file called WSA-with-magisk-stable-MindTheGapps_2207.40000.8.0_x64_Release-Nightlyor else there will be folder with the WSA-with-magisk-stable-MindTheGapps_2207.40000.8.0_x64_Release-Nightly. If there is a folder open it and skip to step 10. NOTE: The name of compressed file or the folder generated in the output folder may be different for you. It will be dependent on the choices made when executing ./run.sh.

  10. Extract the compressed file and open the folder created after the extraction of the file.

  11. Here look for file Run.bat and run it.

    • 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 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 the popup windows disappear without asking administrative permission and WSA is not installed successfully, you should manually run Install.ps1 as Administrator:
      1. Press Win+x and select Windows Terminal (Admin).
      2. 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"
      3. Input PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1 and press Enter.
      4. The script will run and WSA will be installed.
      5. If this workaround does not work, your PC is not supported for WSA.

  12. Magisk/Play Store will be launched. Enjoy by installing LSPosed-Zygisk with Zygisk enabled or Riru and LSPosed-Riru.

FAQ

  • Can I delete the installed folder?

    No.

  • How can I update WSA to a newer version?

    1. Update build scripts:

      git pull

      For more usage of git, referred to https://git-scm.com/book

    2. Rerun the script, 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 a newer version?

    Do the same as updating WSA.

  • How to pass Play Integrity (formerly known as 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 the system as read-write?

    No way in WSA since it's mounted as read-only by Hyper-V. You can modify the system by making a Magisk module. Or directly modify the system.img. Ask Google for help.

  • I cannot adb connect localhost:58526, what to do?

    Make sure developer mode is enabled. If the issue persists, check the IP address of WSA on the setting page and try adb connect ip:5555.

  • Why the Magisk online module is empty?

    Magisk actively removes the online module repository. You can install the 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 v23.0 stable or a lower version?

    No. Magisk has bugs preventing itself from running on WSA. Magisk v24+ has fixed them. So you must use Magisk v24 or later.

  • How can I get rid of Magisk?

    Choose none as the root solution.

  • How to install custom GApps?

    Tutorial

  • Where can I download MindTheGapps?

    You can download from here MindTheGapps (mirror).

    Note that there is no x86_64 pre-build, so you need to build it by yourself (Repository).

    Or you can download the built package for 12.1 and 13 for x86_64 from this page.

  • Is it possible to migrate data from a lower version like 2305 to a newer version?

    This is certainly available, Microsoft's change of read-only partition from 2305's EROFS to read-only EXT4 only affects the read-only system partition.

    It has no effect on the user data partition. Check the logs if there is a failure to boot.

  • How to install KernelSU?

    Tutorial

Credits

The repository is provided as a utility.

Android is a trademark of Google LLC. Windows is a trademark of Microsoft Corporation.

MagiskOnWSALocal (LSPosed/MagiskOnWSALocal)

Searching Database…

10.6K ·GitHub
MagiskOnWSALocal
What is this?A set of build scripts that generates a custom Windows Subsystem for Android (WSA) installer with Magisk root and Google Apps (Play Store) built in, ready to install on Windows 11.
So is this an app I install, or something I run first?It's a script tool, not the app itself: you run it on Linux or WSL2 to build a modified WSA installer package, then run the generated Run.bat on Windows to actually install it.
How do I build and install my own rooted WSA with it?Clone the repo and run ./scripts/run.sh; answer the menus (WSA version, x64 or ARM64, Magisk version, GApps, root solution), then extract the output folder and run Run.bat. If the install silently fails, run Install.ps1 as Administrator.
What do I need on my machine before running it?A Linux machine (x86_64 or arm64) or WSL2 on Windows; Ubuntu, Debian, openSUSE Tumbleweed and Arch are covered. It uses Python 3.7.2+ with requests, aria2, unzip and 7-Zip, but run.sh installs everything automatically.
Can I still use this to get WSA with the Play Store today?Mostly not: the README warns that Magisk on WSA will no longer be available after March 5, 2025. Other pitfalls: an official WSA installation must be uninstalled first, and the installed folder cannot be deleted afterwards.
Does it build for ARM Windows machines too, or only x64?Both ARM64 and x64 are supported for the generated WSA, and the build script itself runs on x86_64 or arm64 Linux; most users pick x64.
What does the finished build include beyond stock WSA?Magisk root, Google Apps via MindTheGapps, the Amazon Appstore removed, a fix for the VPN dialog not showing, device administration support, automatic developer-mode activation on Windows 11, unattended installation and merged language packs.
Can I build it with GApps but without root?Yes — the root solution step offers a 'none' option, meaning no root, so you can get a Play Store-equipped WSA without Magisk.
Which GApps package can I choose?Only MindTheGapps; the README states there is no other variant to pick, and Open GApps support was dropped (it is struck through in the credits).
How do I get LSPosed itself running once WSA is installed?Magisk or the Play Store launches right after installation; enable Zygisk in Magisk and install LSPosed-Zygisk, or use Riru together with LSPosed-Riru.
What are similar projects?WSABuilds, MediaCreationTool.bat, winget-cli, coreutils, tiny11builder, RemoveWindowsAI, windows-cursor-scheme-fix, omarchy-mac
Which topics is it in?windows11, magisk, root, script, windows-11, powershell, arm64, microsoft, installer, agpl, shell, utility
Creator
LSPosed
Size
28.2 MB
Stars
10.6K
Updated
CommitSep 20
Age
4y
Commits · 90 Days