https://github.com/topjohnwu/Magisk/
English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

A kernel-based root solution for Android devices.
su and root access management.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, the arm64-v8a and x86_64 architectures are supported.
[!CAUTION]
Recent kernel versions have implemented a breaking change causing KernelSU to fail and potentially trigger a kernel panic onx86_64! Check the website for more info!
To help translate KernelSU, we no longer accept translation contributions via Weblate. All translations are now handled using LLMs.
If you would like to add support for a new language, feel free to open a PR. Please note that modifications to existing English and Chinese translations are not accepted.
For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.
kernel directory are GPL-2.0-only.kernel directory are GPL-3.0-or-later.Full Changelog: https://github.com/tiann/KernelSU/compare/v3.2.2...v3.2.3
Full Changelog: https://github.com/tiann/KernelSU/compare/v3.2.1...v3.2.2
Full Changelog: https://github.com/tiann/KernelSU/compare/v3.2.0...v3.2.1
shortcut_type intent's extra by @lamprose in https://github.com/tiann/KernelSU/pull/3267NavigationRail support by @YuKongA in https://github.com/tiann/KernelSU/pull/3279Full Changelog: https://github.com/tiann/KernelSU/compare/v3.1.0...v3.2.0
internal/colors.css is empty source when WebUIActivity started by shortcut by @lamprose in https://github.com/tiann/KernelSU/pull/3172setup_selinux using __task_cred directly by @jsoltan226 in https://github.com/tiann/KernelSU/pull/3189Full Changelog: https://github.com/tiann/KernelSU/compare/v3.0.0...v3.1.0
--out-name arg to boot-patch and boot-restore command by @5ec1cff in https://github.com/tiann/KernelSU/pull/2982Full Changelog: https://github.com/tiann/KernelSU/compare/v2.1.2...v3.0.0
New sucompat implementation, fixed a large number of related side-channel attacks
Full Changelog: https://github.com/tiann/KernelSU/compare/v2.0.0...v2.1.2
id_ID by @CEKIKOFGAMERS in https://github.com/tiann/KernelSU/pull/2797Full Changelog: https://github.com/tiann/KernelSU/compare/v1.0.5...v2.0.0
WARNING: Non-GKI devices should not upgrade to this version!
Full Changelog: https://github.com/tiann/KernelSU/compare/v1.0.0...v1.0.1
KernelSU has been born for two years. Today we officially welcome version 1.0!
Due to the fact that we haven't added features to non-GKI devices for a long time, and maintaining them requires a significant amount of time, we have removed support for non-GKI devices. Non-GKI devices can only stay on version 0.9.5 (the manager can update). In the future, we will focus on adding new features for GKI devices.
Our energy is limited, but the rewards are even more limited, so please understand our choice, thank you!
KernelSU now supports installation through kernel modules (LKM) (GKI Only), you can use it with official kernels or third-party kernels; at the same time, the manager has also added installation functionality, you can choose to patch files, install directly, or install after OTA. Regarding the new LKM installation method, there are some tips:
init_boot partition exists, you should choose to patch init_boot; otherwise, patch boot;init_boot partition, you can directly flash back to the stock boot;Have fun!
For a long time, the module functionality of Magisk / KernelSU was limited to executing boot scripts and modifying system files. Now, we are exploring the possibility of endowing modules with the capability to display UI interfaces!
Previously, after installing some modules, users needed to configure them either through the command line or by directly modifying configuration files in specific locations. Clearly, this process was quite inconvenient for users. At times, in order to configure settings, it was even necessary to write a separate app. With the ability for modules to display interfaces, these issues could become a thing of the past.
Moreover, the display interface can be used for more than just configurations. You have the freedom to present anything you'd like to showcase and interact with the user.
The current interface is implemented through WebUI. You can create HTML pages using any web technology and place them in the module's webroot directory. After the module is installed, users can access this page through the KernelSU manager's list of modules. KernelSU also provides a JavaScript library to facilitate interaction with the system.
However, these trials are still in their infancy, and the jsapi is not yet stable. We welcome your feedback!
Changelog:
For a long time, the module functionality of Magisk / KernelSU was limited to executing boot scripts and modifying system files. Now, we are exploring the possibility of endowing modules with the capability to display UI interfaces!
Previously, after installing some modules, users needed to configure them either through the command line or by directly modifying configuration files in specific locations. Clearly, this process was quite inconvenient for users. At times, in order to configure settings, it was even necessary to write a separate app. With the ability for modules to display interfaces, these issues could become a thing of the past.
Moreover, the display interface can be used for more than just configurations. You have the freedom to present anything you'd like to showcase and interact with the user.
The current interface is implemented through WebUI. You can create HTML pages using any web technology and place them in the module's webroot directory. After the module is installed, users can access this page through the KernelSU manager's list of modules. KernelSU also provides a JavaScript library to facilitate interaction with the system.
However, these trials are still in their infancy, and the jsapi is not yet stable. We welcome your feedback!
Changelog:
Fix memory leak
module.prop causing module directory confusion./debug_ramdisk as temporary directory.We’re excited to report that we’ve delivered on the App Profile feature we promised 5 months ago! In this release, we have added an important feature to App Profile: Templates. You can create templates by yourself, import templates created by others, or directly use online templates. Templates can be directly applied to App Profile, without having to manually set each configuration! Therefore, even if you don’t understand the complex concepts in App Profile, you can easily restrict ROOT permissions through templates. In addition, welcome to contribute rules to online templates!
Changelog:
post-mount stage for module and common scripts.Changelog:
boot-completed, which will run after system finished booting, available for both common and module scripts.更新日志:
boot-completed,将会在系统启动完毕后执行,支持 common 和模块脚本。