[!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.
KernelSU is a kernel-based root solution for Android GKI devices. It works in kernel mode and grants root permission to userspace applications directly in kernel space.
- Kernel-based
suand root access management. - Module system based on Metamodule
- App Profile: Lock up the root power in a cage.
- main branch
curl -LSs "https://raw.githubusercontent.com/RapliVx/KernelSU/refs/heads/master/kernel/setup.sh" | bash -s master
- susfs branch
Warning
This branch is not always updated.
curl -LSs "https://raw.githubusercontent.com/RapliVx/KernelSU/refs/heads/susfs-rksu-master/kernel/setup.sh" | bash -s susfs-rksu-master
- Syscall hook:
- Used for Loadable Kernel Module (LKM) or GKI with this hook.
- Default hook method on GKI kernels.
- Does not support armv7l.
- Need
CONFIG_KSU_SYSCALL_HOOK=y&CONFIG_KPROBES=y,CONFIG_KRETPROBES=y,CONFIG_HAVE_SYSCALL_TRACEPOINTS=y
- Manual hook:
- See this repository for more information
- Default hook method on Non-GKI kernels, with condition that
CONFIG_KPROBESoff by default. - Need
CONFIG_KSU_MANUAL_HOOK=y
- Kernel compatibility:
- Android GKI 2.0 (5.10+): aarch64, armv8l, x86_64
- Android GKI 1.0 (5.4): aarch64, armv8l, armv7l
- Non-GKI (4.4-4.19): aarch64, armv8l, armv7l
- Application compaibility (ksud/manager):
- arm64-v8a, armeabi-v7a, x86_64
- MamboSU Telegram Group: @KamiSkizofrenia
For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.
- Files under the
kerneldirectory are GPL-2.0-only. - All other parts except the
kerneldirectory are GPL-3.0-or-later.
- kernel-assisted-superuser: the KernelSU idea.
- Rissu: Base KernelSU Source Driver
- Magisk: the powerful root tool.
- genuine: apk v2 signature validation.
- Diamorphine: some rootkit skills.
- simonpunk: susfs add-on.
- rifsxd: UI Design