I became a dad last night and the amount of time I spend on KernelSU will probably decrease significantly. We welcome anyone to contribute to the project in any form, I will still review and make suggestions for every PR, thank you all!

To all KernelSU users:

Please upgrade to version 0.6.9 or above AS SOON AS POSSIBLE, it contains a very important security fix; in the worst case, the vulnerability(CVE-2023-5521) may cause root privileges to be taken over by malicious programs.

Please note that just upgrading the Manager application has no effect, you need to upgrade the kernel!

Credits to 0x33c0unt for submitting this vulnerability. His detailed denoscription and PoC provided us with great help!

Also I would like to reiterate that we welcome any security researchers to discuss KernelSU's potential attack surfaces with us. We will spare no effort to improve KernelSU's security.

Some explanations:

1. This does not mean that KernelSU is unsafe. Many vulnerabilities are submitted in the Android system itself every month; in addition, this problem also exists in Magisk.
2. If you keep the manager installed, you will never be affected.
3. If you uninstall the manager, the malicious application needs to be installed on your system to take effect, and the official manager will not work. And we have never received this type of feedback.
4. This fix is not resistant to attacks when the "ignore invalid digest error" function of the Xposed module "CorePatch" is turned on.
5. Finally, upgrade now.

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:

1. [Security] Fix a security issue similar to CVE-2023-5521, please upgrade as soon as possible; credits to qwerty472123@github!
2. [SU] App Profile now supports templates!
3. [Module] Fixed the bug that the module directory may be accidentally umounted, causing the manager module directory to be empty.
4. [SU] Fixed the issue where the allowlist may be messed up after an app is uninstalled.
5. [Kernel] Add android14-5.15 and android14-6.1, supporting Pixel8 series.
6. [SU] App Profile’s capability no longer requires CAP_DAC_READ_SEARCH and can run without any capability.
7. [Kernel] Fixed the bootloop issues when working with Magisk.

https://github.com/tiann/KernelSU/releases/tag/v0.7.2

- [SU] Fixed the issue of incorrect allowlist after an app with root permissions is uninstalled.
- [SU] Fixed an issue that caused bootloop when uninstalling an application in multi-user after being granted root permissions.
- [kernel] Support Linux kernel version 6.4.
- [Module] Fixed the problem of non-standard module.prop causing module directory confusion.
- [Module] Update busybox to 1.36.1.
- [Module] Support using /debug_ramdisk as temporary directory.
- [Security] Strengthen signature verification to avoid root privileges being taken over when using unofficial managers (CVE-2023-49794).

Although I am not sure what has transpired, as someone who has also been the target of malicious slander, I understand and support the decision of the LSPosed developers.

For a long time, the module functionality of Magisk / KernelSU was limited to executing boot noscripts 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!

KernelSU version 0.8.0 use sparse image to storage module files. If you do not wait patiently for the module installation process to end after upgrading (it takes time to migrate the old version to the new version), but forcefully stop the process and then switch to the old version of the manager, then serious problems will occur at this time.

Because the old version of the manager cannot handle sparse image, it treats sparse files as ordinary files, and one copy is enough to use up all the storage space on your phone.

If you switch to an old manager version, be sure to delete /data/adb/ksu/modues.img and /data/adb/ksu/modules_update.img!

https://github.com/tiann/KernelSU/releases/tag/v0.8.1

And the webui docs

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:

1. LKM does not support non-GKI kernels, and will not support them in the future;
2. When patching files, if the init_boot partition exists, you should choose to patch init_boot; otherwise, patch boot;
3. If you have already installed the GKI kernel provided by KernelSU and want to switch to the LKM method, you need to flash back to the stock kernel; if your device has an init_boot partition, you can directly flash back to the stock boot;
4. The installation method of GKI kernel and LKM will always exist, use whichever you like; in the future, it will also support flashing GKI kernel in the manager.

https://github.com/tiann/KernelSU/releases/tag/v0.9.0

https://github.com/tiann/KernelSU/releases/tag/v0.9.2

- [manager]: Support offline patching of the kernel.
- [kernel]: Fix issue with ColorOS.
- [kernel]: Hide traces of LKM in user space.
- [manager]: Fix possible errors during OTA upgrades.

The installation guide has been updated, with added instructions for LKM mode: https://kernelsu.org/guide/installation.html#introduction

If you wish to contribute code to KernelSU, here are some good first issues:

- https://github.com/tiann/KernelSU/issues/1664
- https://github.com/tiann/KernelSU/issues/1571
- https://github.com/tiann/KernelSU/issues/1542

KernelSU has been around for nearly two years and has stabilized, and we plan to move to 1.0 in the future; here are some adjustments:

1. In principle, we only accept Bug Reports and do not accept external Feature Requests; if you want new features, you are welcome to submit a Pull Request. We will still develop new features that we think are interesting/cool, such as sulog, ksufs, webui, etc.
2. Since non-GKI kernels are full of weird things, it is very time-consuming to deal with this kind of problem; from now on, we will only deal with issues related to GKI kernels. For problems with old kernels, please search for issues by yourself; we will give up supporting non-GKI kernels in version 1.0. Since non-GKI kernels are no longer updated, you can continue to use KernelSU version 0.9.x; in fact, starting from 0.7.0, we have not added any new features to non-GKI kernels.

Our energy is limited, but the rewards are even more limited, so please understand our choice, thank you!

You can choose to install the KernelSU manager exclusively in Private Space on Android 15 now.

KernelSU provides systemless modification of the system through overlayfs, but this feature has become a major and fragile detection point, with many detection methods for KernelSU stemming from it. Therefore, we plan to launch the metamodule feature, which will transfer certain capabilities of the module system to the metamodule. This will maintain the stability and security of KernelSU itself while releasing greater innovative potential for the module system.

For example, after transferring the mount capability to the metamodule, there can be various mounting methods:

1. No mount; for users who only use mountless modules, there is no need to bear the side effects brought by mounting.

2. Using overlayfs for mounting; with rw support, direct writing to partitions like /system can be enabled.

3. Magic mount; utilizing the mounting methods provided by Magisk for better compatibility.

4. There can also be several other implementations, such as fuse-overlay mount, custom vfs mount, etc.

The metamodule can also take over the module installation process, providing unique capabilities for modules, such as supporting kernel modules, etc.

Welcome to the era of metamodule!