KernelSU

A Kernel-based root solution for Android devices.

Note

Official KernelSU support for Non-GKI kernels has been ended.

This is unofficial KernelSU fork, all changes are not guaranteed stable!

All rights reserved to @tiann, the author of KernelSU.

How to add

curl -LSs "https://raw.githubusercontent.com/rsuntk/KernelSU/main/kernel/setup.sh" | bash -s main

Hook method

1. KPROBES hook:
   • Used for Loadable Kernel Module (LKM)
   • Default hook method on GKI kernels.
   • Need # CONFIG_KSU_MANUAL_HOOK is not set & CONFIG_KPROBES=y
   • Require CONFIG_KPROBES
2. Manual hook:
   • Require: https://kernelsu.org/guide/how-to-integrate-for-non-gki.html#manually-modify-the-kernel-source
   • Default hook method on Non-GKI kernels.
   • Need CONFIG_KSU_MANUAL_HOOK=y

Features

1. Kernel-based su and root access management.
2. Module system based on 5ec1cff's Magic Mount API on KernelSU
3. App Profile: Lock up the root power in a cage.
4. Bringing back non-GKI/GKI 1.0 support
5. Added bare armeabi-v7a/arm32 support.

Compatibility State

KernelSU (before v1.0.0) officially supports Android GKI 2.0 devices (kernel 5.10+).

Older kernels (4.4+) are also compatible, but the kernel will have to be built manually.

With more backports, KernelSU can supports 3.x kernel (3.4-3.18).

Currently, only arm64-v8a and armeabi-v7a (bare) are supported.

Usage

• Installation Instruction
• How to build?
• Official Website

Discussion

• Official KernelSU Telegram: @KernelSU
• Unofficial RKSU Telegram: @rsukrnlsu_grp

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

• Files under the kernel directory are GPL-2.0-only.
• All other parts except the kernel directory are GPL-3.0-or-later.

Credits

• kernel-assisted-superuser: the KernelSU idea.
• Magisk: the powerful root tool.
• genuine: apk v2 signature validation.
• Diamorphine: some rootkit skills.
• 5ec1cff: magic mount api implementation.