Installation


Where to start

It’s always a good idea to read through, at least, the official Magisk Documentation over on GitHub. Other useful information can often be found in the XDA support thread.

Known issues

There may be issues with certain devices, ROMs and/or apps and Magisk. Check the Magisk FAQ for some information about currently known issues.

Things to keep handy

There are a couple of things that are good to keep accessible, making it easier to recover from any problems that might arise.



Installation

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 app 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 app 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 (Zackptg5's universal disabler is a prime example). Just not through the Magisk app.

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 "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 "Working with dm-verity and forced encryption" for more details.

Recovery mode
What is this "Recovery mode" that I see in the Magisk app?

Recovery mode needs to be enabled if you are installing Magisk on a device that doesn't have ramdisk in the boot partition. On these devices you need to install Magisk into the recovery image rather than the boot image, hence "Recovery mode". For details, see the official installation instructions in the Magisk documentation linked above.

Note though, that since Android is such a fractured ecosystem, detection of the ramdisk might not always be accurate (Xiaomi). So, if the result in the Magisk app is "no ramdisk", but patching the recovery image fails, give the boot image a go instead.

If you're using an older version of the app (that's not something that'll be supported, of course) that doesn't show if there's a ramdisk present, you can go by the general rule that a system-as-root device that doesn't have an A/B setup likely will have to install Magisk to recovery.
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki