hjbfs / kernelsu

A Kernel based root solution for Android GKI

English | 中文

KernelSU

A Kernel based root solution for Android GKI.

Before Reading

Now KernelSU supports old kernel under 5.10, but THERE WILL NEVER be a CI for old kernels, because they are not generic. ANY ISSUES ABOUT HOW TO COMPILE A OLD KERNEL WILL NOT BE ANSWERED AND WILL BE CLOSED.

KernelSU is in a early development stage and you should not put it into production enviroment. KernelSU developers will not be responsible for any of your losses.

If you face any issue, feel free to open a issue and tell us about it!

Compatibility State

Now KernelSU will work on these version of kernels without any modification：

• 5.15
• 5.10
• 5.4
• 4.19

If you confirm KernelSU works on other version, open a issue tell us about it!

Usage

1. Flash a custom kernel with KernelSU, you can build it yourself or download it from CI.
2. Install Manager App and enjoy :)

For old kernels under 5.10, you must build custom kernels by yourself.

Build

Build GKI Kernel

1. Download the GKI source first, you can refer the GKI build instruction
2. cd <GKI kernel source dir>
3. curl -LSs "https://raw.githubusercontent.com/tiann/KernelSU/main/kernel/setup.sh" | bash -
4. Build the kernel.

Build the Manager App

Android Studio / Gradle

Discussion

@KernelSU

License

GPL-3

Credits

• kernel-assisted-superuser: the KernelSU idea.
• genuine: apk v2 signature validation.
• Diamorphine: some rootkit skills.
• Magisk: the sepolicy implementation.