https://github.com/tiann/KernelSU

A Kernel based root solution for Android
https://github.com/tiann/KernelSU

android kernel kernelsu root su

Last synced: about 1 month ago
JSON representation

A Kernel based root solution for Android

• Host: GitHub
• URL: https://github.com/tiann/KernelSU
• Owner: tiann
• License: gpl-3.0
• Created: 2022-12-09T14:03:54.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-18T11:51:45.000Z (about 1 month ago)
• Last Synced: 2025-03-19T21:16:06.222Z (about 1 month ago)
• Topics: android, kernel, kernelsu, root, su
• Language: Kotlin
• Homepage: https://kernelsu.org
• Size: 17.4 MB
• Stars: 11,779
• Watchers: 105
• Forks: 2,087
• Open Issues: 27
• Metadata Files:
  • Readme: docs/README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

• stars - tiann/KernelSU
• awesome-repositories - tiann/KernelSU - A Kernel based root solution for Android (Kotlin)
• awesome-android-root - KernelSU - A Kernel based root solution for Android. `FOSS` (Root Apps / Root Specific)

README

        
**English** | [Español](README_ES.md) | [简体中文](README_CN.md) | [繁體中文](README_TW.md) | [日本語](README_JP.md) | [한국어](README_KR.md) | [Polski](README_PL.md) | [Português (Brasil)](README_PT-BR.md) | [Türkçe](README_TR.md) | [Русский](README_RU.md) | [Tiếng Việt](README_VI.md) | [Indonesia](README_ID.md) | [עברית](README_IW.md) | [हिंदी](README_IN.md) | [Italiano](README_IT.md)

# KernelSU



A kernel-based root solution for Android devices.

[![Latest release](https://img.shields.io/github/v/release/tiann/KernelSU?label=Release&logo=github)](https://github.com/tiann/KernelSU/releases/latest)

[![Weblate](https://img.shields.io/badge/Localization-Weblate-teal?logo=weblate)](https://hosted.weblate.org/engage/kernelsu)

[![Channel](https://img.shields.io/badge/Follow-Telegram-blue.svg?logo=telegram)](https://t.me/KernelSU)

[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-orange.svg?logo=gnu)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)

[![GitHub License](https://img.shields.io/github/license/tiann/KernelSU?logo=gnu)](/LICENSE)

## Features

1. Kernel-based `su` and root access management.

2. Module system based on [OverlayFS](https://en.wikipedia.org/wiki/OverlayFS).

3. [App Profile](https://kernelsu.org/guide/app-profile.html): Lock up the root power in a cage.

## Compatibility state

KernelSU officially supports Android GKI 2.0 devices (kernel 5.10+). Older kernels (4.14+) are also supported, but the kernel will need to be built manually.

With this, WSA, ChromeOS, and container-based Android are all supported.

Currently, only the `arm64-v8a` and `x86_64` architectures are supported.

## Usage

- [Installation](https://kernelsu.org/guide/installation.html)

- [How to build](https://kernelsu.org/guide/how-to-build.html)

- [Official website](https://kernelsu.org/)

## Translation

To help translate KernelSU or improve existing translations, please use [Weblate](https://hosted.weblate.org/engage/kernelsu/). PR of Manager's translation is no longer accepted, because it will conflict with Weblate.

## Discussion

- Telegram: [@KernelSU](https://t.me/KernelSU)

## Security

For information on reporting security vulnerabilities in KernelSU, see [SECURITY.md](/SECURITY.md).

## License

- Files under the `kernel` directory are [GPL-2.0-only](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html).

- All other parts except the `kernel` directory are [GPL-3.0-or-later](https://www.gnu.org/licenses/gpl-3.0.html).

## Credits

- [Kernel-Assisted Superuser](https://git.zx2c4.com/kernel-assisted-superuser/about/): The KernelSU idea.

- [Magisk](https://github.com/topjohnwu/Magisk): The powerful root tool.

- [genuine](https://github.com/brevent/genuine/): APK v2 signature validation.

- [Diamorphine](https://github.com/m0nad/Diamorphine): Some rootkit skills.