Skip to main content

​
About Magisk on WSA

Magisk is a systemless root solution for Android that provides root access without modifying system partitions. WSABuilds integrates Magisk to enable:
  • Root access for advanced Android apps
  • Systemless modifications via Magisk modules
  • SafetyNet/Play Integrity workarounds (limited)
  • Advanced debugging and development
Stability Notice: Some WSA builds may experience issues where Magisk modules disappear after reboot on certain PCs. See GitHub Issue #154 for workarounds.

​
Magisk Versions

WSABuilds offers different Magisk variants to suit various needs:
Official Magisk (Stable)The standard Magisk release maintained by topjohnwu.
  • Package: com.topjohnwu.magisk
  • Update frequency: Monthly or as needed
  • Stability: Highest
  • Recommended for: Most users
Features:
  • Core root functionality
  • Module system
  • MagiskHide (deprecated, replaced by DenyList)
  • Zygisk support

​
First Launch

After installing WSA with Magisk:
1

Launch Magisk Manager

Open the Start Menu and search for “Magisk” or look for the Magisk app in the WSA app list.
2

Grant root access

Magisk will initialize on first launch. This may take a few moments.
Unlike on physical devices, Magisk on WSA doesn’t require a reboot after initialization.
3

Configure settings (optional)

Navigate to Magisk settings to configure:
  • Zygisk: Enable for advanced module support
  • DenyList: Hide root from specific apps
  • Systemless hosts: Block ads system-wide

​
Managing Root Access

​
Granting Root to Apps

When an app requests root access:
  1. A Magisk prompt will appear
  2. Review the app name and package
  3. Choose:
    • Grant - Allow root access
    • Deny - Block root access
    • Set duration (permanent, timeout, etc.)

​
Managing Root Permissions

1

Open Superuser section

In Magisk Manager, tap the shield icon or navigate to Superuser.
2

View granted apps

See all apps with root access and their permission status.
3

Modify permissions

Tap any app to:
  • Revoke root access
  • Change access duration
  • View access logs

​
Installing Magisk Modules

Magisk modules provide systemless modifications without altering system files.
Module Compatibility: Not all Magisk modules designed for physical Android devices work properly on WSA. Test modules carefully and keep backups.

​
Installation Methods

​
Module Installation Examples

# Download LSPosed module
wget https://github.com/LSPosed/LSPosed/releases/download/v1.9.2/LSPosed-v1.9.2-7024-zygisk-release.zip

# Install via ADB
adb push LSPosed-v1.9.2-7024-zygisk-release.zip /data/local/tmp/
adb shell su -c magisk --install-module /data/local/tmp/LSPosed-v1.9.2-7024-zygisk-release.zip
adb reboot

​
Managing Modules

1

View installed modules

Open Magisk Manager → Modules to see all installed modules.
2

Enable/disable modules

Toggle the switch next to each module:
  • Enabled (green): Module is active
  • Disabled (gray): Module is inactive
WSA must be restarted for changes to take effect.
3

Remove modules

Tap the trash icon next to a module to uninstall it. Restart WSA after removal.

​
Module Troubleshooting

Known Issue: Some WSA builds experience this problem.Workaround:
  1. Install modules immediately after WSA installation
  2. Avoid restarting WSA unless necessary
  3. See temporary workaround
  4. Consider switching to a stable WSA version (2211 or earlier)
Solution: Boot into Safe Mode:
  1. Connect via ADB
  2. Disable problematic module: 
    adb shell su -c magisk --remove-modules
  3. Restart WSA
Common issues:
  • Modules that modify kernel parameters
  • Hardware-specific modules (camera, sensors)
  • Modules requiring specific device models
Solution: Only use modules designed for system-level modifications, not hardware interactions.

​
Magisk Configuration

​
Zygisk
toggle
default:"disabled"
Enable Zygisk for advanced module support (like LSPosed).Requires WSA restart after enabling.
​
DenyList
toggle
default:"disabled"
Enable DenyList to hide root from specific apps.Configure in Magisk Settings → Configure DenyList.
DenyList effectiveness is limited on WSA. Banking apps and apps with strong SafetyNet checks may still detect root.
​
Systemless Hosts
toggle
default:"disabled"
Enable Systemless Hosts for system-wide ad blocking.Requires a hosts module or manual hosts file configuration.

​
DenyList Configuration

Hide root from specific apps:
1

Enable DenyList

Magisk Settings → Enable “Enforce DenyList”
2

Configure DenyList

Tap “Configure DenyList” to see all installed apps.
3

Select apps to hide root from

Toggle apps that should not detect root:
  • Banking apps
  • Payment apps
  • Games with anti-cheat
  • Netflix, Disney+, etc.
4

Restart affected apps

Force close and restart apps for changes to take effect.

​
Updating Magisk

Magisk on WSA cannot be updated directly through the Magisk Manager app.
1

Check for new WSABuilds releases

Visit the Releases page to see if a newer Magisk version is available.
2

Download updated build

Download the WSA build with the desired Magisk version.
3

Update WSA

Follow the update procedure to replace your current installation.
User data and installed apps will be preserved during the update.

​
Advanced: Magisk Customization

For users building custom WSA packages:

​
Using Custom Magisk Builds

./build.sh --root-sol magisk --magisk-ver canary

​
Magisk Files Location

Key Magisk files within WSA: 
/data/adb/magisk/          # Magisk root directory
/data/adb/modules/         # Installed modules
/data/adb/magisk.db        # Magisk settings database
/sbin/.magisk/             # Magisk binaries
Access via ADB: 
adb shell
su
cd /data/adb/magisk

​
Known Limitations

Magisk on WSA has limitations compared to physical devices:
  • SafetyNet/Play Integrity: Cannot be fully bypassed due to VM environment
  • Hardware modules: Modules requiring hardware access won’t work
  • Kernel modules: Cannot modify kernel parameters
  • Boot image modifications: Not applicable to WSA architecture
  • Module persistence: May experience issues on some WSA versions

​
Getting Help

WSABuilds Discord

Get community support for Magisk on WSA

Magisk Documentation

Official Magisk documentation

GitHub Issues

Report Magisk-related problems

Module Repository

Browse available Magisk modules

Build docs developers (and LLMs) love

Get started for freeTalk to us