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 [[ | release thread]] for information about what Magisk is and how to install it. Other useful information can be found in the official [[ | Magisk Documentation]] over on [[ | GitHub]] and the [[ | support thread]].

===**Known issues**===
There may be issues with certain devices, ROMs and/or apps and Magisk. Check the [[ | release thread]] for information about currently known issues.

===**Things to keep on your device**===
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 ([[ | release thread]]) or [[ | GitHub]]).
- Magisk Manager apk ([[ | release thread]] or [[ | GitHub]]).
- Uninstall zip ([[ | release thread]]) or [[ | GitHub]]).
- 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 before patching it. This can also be used.
- Module zips.

Installing Magisk is usually quite straightforward, but make sure to follow the installation instructions in the official [[ | 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 might be 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.

===**Install options**===
==**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 [[MaigskIssues | "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 [[MaigskIssues | "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