-
Linux (x86_64 or arm64)
The following dependencies are required:
DistrOS Debian lzip patchelf e2fsprogs python3 aria2 attr unzip sudo
whiptail
qemu-utils
python3-venv
python3-pip
p7zip-full
openSUSE Tumbleweed Same as above dialog
qemu-tools
python3-venvctrl
Same as above Arch Same as Debian libnewt
qemu-img
Same as Debian python-pip
p7zip
The python3 library
requests
is used.Python version ≥ 3.7.2.
- Integrate Magisk and GApps in a few clicks within minutes
- Keep each build up to date
- Support both ARM64 and x64
- Support MindTheGapps
- Remove Amazon Appstore
- Fix VPN dialog not showing (use our VpnDialogs app)
- Add device administration feature
- Unattended installation
- Automatically activates developers mode in Windows 11
- Update to the new version while preserving data with a one-click script
- Merged all language packs
-
Star (if you like).
-
Clone the repo to local:
git clone https://github.com/LSPosed/MagiskOnWSALocal.git --depth 1
-
Run
cd MagiskOnWSALocal
. -
Run
./scripts/run.sh
. -
Select the WSA version and its architecture (mostly x64).
-
Select the version of Magisk.
-
Choose which brand of GApps you want to install:
-
MindTheGapps
There is no other variant we can choose.
-
-
Select the root solution (none means no root).
-
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
anddownload
will be generated in theMagiskOnWSALocal
folder. Go to theoutput
folder. While running the./run.sh
script in the step 3, if you selectedYes
forDo you want to compress the output?
then inoutput
folder you will see a compressed file calledWSA-with-magisk-stable-MindTheGapps_2207.40000.8.0_x64_Release-Nightly
or else there will be folder with theWSA-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 theoutput
folder may be different for you. It will be dependent on the choices made when executing./run.sh
. -
Extract the compressed file and open the folder created after the extraction of the file.
-
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:- Press
Win+x
and selectWindows Terminal (Admin)
. - Input
cd "{X:\path\to\your\extracted\folder}"
and pressenter
, and remember to replace{X:\path\to\your\extracted\folder}
including the{}
, for examplecd "D:\wsa"
- Input
PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1
and pressEnter
. - The script will run and WSA will be installed.
- If this workaround does not work, your PC is not supported for WSA.
- Press
-
Magisk/Play Store will be launched. Enjoy by installing LSPosed-Zygisk with Zygisk enabled or Riru and LSPosed-Riru.
-
Can I delete the installed folder?
No.
-
How can I update WSA to a newer version?
-
Update build scripts:
git pull
For more usage of git, referred to https://git-scm.com/book
-
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, rerunInstall.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
andadb 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?
-
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.
-
Can I switch OpenGApps to MindTheGapps and keep user data in a previous build?
No. You should wipe data after changing the GApps brand. Otherwise, you will find that the installed GApps are not recognized.
-
WSA with OpenGApps integrated fails to start.
OpenGApps has not yet released a version built for Android 12L and 13, only built for Android 11, which may not be compatible and thus cause crashes. Consider switching to MindTheGapps.
-
How to install KernelSU?
- StoreLib: API for downloading WSA
- Magisk: The most famous root solution on Android
- The Open GApps Project: One of the most famous Google Apps packages solution
- WSA-Kernel-SU and kernel-assisted-superuser: The kernel
su
for debugging Magisk Integration - WSAGAScript: The first GApps integration script for WSA
- erofs-utils: Pre-build
erofs-utils
with erofsfuse enabled
The repository is provided as a utility.
Android is a trademark of Google LLC. Windows is a trademark of Microsoft Corporation.