Wiki source for MagiskInstallation


Show raw source

@@[[Magisk | -- To the top/main article --]]@@
=====**{{color text="Installation" c="blue"}}**=====

===**Where to start**===
It’s always a good idea to read through, at least, the official [[https://topjohnwu.github.io/Magisk/ | Magisk Documentation]] over on [[https://github.com/topjohnwu/Magisk | GitHub]]. Other useful information can often be found in the [[https://forum.xda-developers.com/apps/magisk/mod-magisk-v1-universal-systemless-t3432382 | XDA support thread]].

===**Known issues**===
There may be issues with certain devices, ROMs and/or apps and Magisk. Check the [[https://topjohnwu.github.io/Magisk/faq.html | Magisk FAQ]] for some information about currently known issues.

===**Things to keep handy**===
There are a couple of things that are good to keep on your device, making it easier to recover from any problems that might arise.
---
- Magisk zip ([[https://github.com/topjohnwu/Magisk/releases | GitHub]]. Never download Magisk files from anywhere else!).
- Magisk Manager apk ([[https://github.com/topjohnwu/Magisk/releases | GitHub]]. Never download Magisk files from anywhere else!).
- Uninstall zip ([[https://github.com/topjohnwu/Magisk/releases | GitHub]]. Never download Magisk files from anywhere else!).
- A copy of a clean boot image for your ROM (can be flashed to restore your device in case of problems). Most of the time, the uninstall zip (see above) is enough, but just in case. Disabling Magisk by flashing an untouched boot image will also keep the Magisk image intact. If you don't know how to get an untouched boot image for your device, your best bet is to search through your device's forum. The Magisk installation script will put a packed up backup of your boot image in /data/magisk_backup_<sha1 checksum> before patching it. This can also be used.
- Module zips.

===**Installation**===
Installing Magisk is usually quite straightforward, but make sure to follow the installation instructions in the official [[https://topjohnwu.github.io/Magisk/ | Magisk Documentation]]. After you've got Magisk installed you can install Magisk Modules through the Manager or via a custom recovery (e.g. TWRP).

Since Google and different OEMs are changing things a lot starting from Android Pie, there are popping up more and more limitations for installing and running Magisk. Make sure to take a look at the docs to see if there's any specific instructions that apply to your device.

**Note!** On A/B devices it is a good idea to __not__ install TWRP, but only __boot__ it through fastboot:
%%fastboot boot twrp.img%%
Actually installing TWRP may lead to issues booting the device if you also install Magisk, since the recovery resides in the boot image.

===**Advanced Settings/Install options**===
From Magisk Manager v8.0.0 these options will only be available on supported legacy devices. For most modern devices they simply won't show, since they have the possibility of causing way more issues for the general user than it's worth. The tools are still available for advanced users and developers in magiskboot.

If you do not see these options, it usually means that you do not need them. If you still do, for whatever reason, there are other options to reach the same functionality ([[https://forum.xda-developers.com/android/software/universal-dm-verity-forceencrypt-t3817389 | Zackptg5's universal disabler]] is a prime example). Just not through the Magisk Manager.

==**Preserve AVB 2.0/dm-verity**==
This is used to disable or preserve Android Verified Boot on your device. Dm-verity is used by the system to ensure that the device hasn't been tampered with in and let's the user know if this is the case. Since we do want to tamper with the system, most devices want to disable this when installing Magisk. But, there are those devices that need it to still be enabled or they won't boot. //See [[MagiskInstallationIssues | "Working with dm-verity and forced encryption"]]// for more details.

==**Preserve enforced encryption**==
By default, Android encrypts user data and the kernel enforces this state so that you cannot use your device without encryption. Some user do want to disable encryption on their devices, and if so they need to have this option disabled. //See [[MagiskInstallationIssues | "Working with dm-verity and forced encryption"]]// for more details.

==**Recovery mode**==
What is this "Recovery mode" that I see in the Magisk Manager?

Recovery mode needs to be enabled if you are installing Magisk on a system-as-root device that does not have a A/B partition setup. On these devices you need to install Magisk into the recovery image rather than the boot image, hence "Recovery mode".
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki