LSPosed/MagiskOnWSALocal Installation Guide
How to install LSPosed/MagiskOnWSALocal. Official project installation instructions and setup guide.
Automated Install (Recommended)
Quick installation instructions for LSPosed/MagiskOnWSALocal. This is the fastest way to complete project installation and setup.
Install via curl
curl -fsSL https://hexmos.com/ipm-install | bash &&
ipm i LSPosed/MagiskOnWSALocalInstall via npx
npx @hexmos/ipm i LSPosed/MagiskOnWSALocalPrerequisites
Python
libraryVersion: >=3.7.2
Git
system_toolUsed for version control and cloning repositories.
curl
system_toolUsed to download files from the internet.
aria2c
system_toolA fast and efficient download manager for large files.
unzip
system_toolUsed to extract compressed files.
sudo
system_toolA command-line utility for executing privileged commands.
whiptail
system_toolA GUI tool for creating dialog boxes.
python3
libraryVersion: 3.8+
requests
libraryUsed to make HTTP requests.
p7zip-full
system_toolA powerful archive manager for compressing and decompressing files.
venv
librarypip
package_managerUsed to install and manage Python packages.
Manual Installation Methods
Manual installation instructions. How to install from GitHub source.
Installation via MagiskOnWSALocal Repository
git clone https://github.com/LSPosed/MagiskOnWSALocal.git --depth 1
cd MagiskOnWSALocal
run.sh
./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
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 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-Nightly or 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.
extract the compressed file and open the folder created after the extraction of the file
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.)
Magisk/Play Store will be launched. Enjoy by installing LSPosed-Zygisk with Zygisk enabled or Riru and LSPosed-Riru.Download and Run the Installer
Invoke-WebRequest -Uri "https://github.com/LSPosed/MagiskOnWSALocal/releases/latest/download/MagiskOnWSALocal.exe" -OutFile "./MagiskOnWSALocal.exe"
"./MagiskOnWSALocal.exe"
Remove-Item "./MagiskOnWSALocal.exe"Post Installation Steps
- Open the Magisk app and select the GApps you want to install.
- Launch the Magisk Manager app and choose the desired version of Magisk.
- Select the root solution (none means no root) and proceed with installation.
Useful Links
Magisk Documentation
Official documentation for Magisk on WSA.
MindTheGapps GApps Installation Guide
Guide to installing MindTheGapps GApps on WSA.
Magisk On WSA Installation Guide
Detailed instructions on how to install and configure Magisk on WSA.
KernelSU Installation Guide
Detailed instructions on how to install and configure KernelSU on WSA.
WSA Installation Guide
Detailed instructions on how to install and configure WSA.
