Go to file

Vuong Kha Sieu 8d31bd3e5a Create wireguard.root template (#2249 )

These two permission is absolutely required:
- CAP_NET_ADMIN is needed for modifying routes.
- CAP_NET_RAW is for modifying iptables.
When the app starts to set up a tunnel, it seems to execute "cat
/sys/module/wireguard/version" to check if wireguard kernel module is
loaded or not. Despite the permission seems okay, without
CAP_DAC_READ_SEARCH it could not read the version number and threw an
error in the application log.
CAP_DAC_OVERRIDE is needed optionally for installing Wireguard command
line tools. It could be turned back off once the binaries have been
copied.

2024-12-13 12:21:22 +08:00

.github

build(deps): bump peter-evans/create-pull-request from 6 to 7 in the actions group (#2031 )

2024-09-05 10:45:59 +08:00

docs

Add Italian translations for README (#2018 )

2024-08-29 11:37:22 +08:00

js: add moduleInfo method (#2057 )

2024-09-14 21:52:11 +08:00

kernel

kernel: Relax dentry_path_raw compare in core_hook (#2041 )

2024-09-07 10:59:06 +08:00

manager

build(deps): bump the maven group across 1 directory with 8 updates (#2217 )

2024-11-22 14:49:17 +08:00

scripts

Fix ksubot session file ext dup (#1672 )

2024-04-27 00:10:54 +08:00

userspace

build(deps): bump the crates group across 1 directory with 28 updates (#2228 )

2024-11-22 14:48:40 +08:00

website

Create wireguard.root template (#2249 )

2024-12-13 12:21:22 +08:00

.gitattributes

Upgrade Gradle and AGP (#1431 )

2024-03-08 10:31:41 +08:00

.gitignore

manager: refactor to use AGP 8.0.0 (#414 )

2023-04-21 16:19:49 +08:00

justfile

misc: Add just command

2024-02-29 20:35:03 +08:00

LICENSE

Initial commit

2022-12-09 22:03:55 +08:00

SECURITY.md

Create SECURITY.md

2023-10-09 22:53:21 +08:00

docs/README.md

KernelSU

A Kernel-based root solution for Android devices.

Features

Kernel-based su and root access management.
Module system based on OverlayFS.
App Profile: 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 compatible, but the kernel will have to be built manually.

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

Currently, only arm64-v8a and x86_64 are supported.

Usage

Translation

To help translate KernelSU or improve existing translations, please use Weblate. PR of Manager's translation is no longer accepted, because it will conflict with Weblate.

Discussion

Telegram: @KernelSU

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

Files under the kernel directory are GPL-2.0-only.
All other parts except the kernel directory are GPL-3.0-or-later.

Credits

kernel-assisted-superuser: the KernelSU idea.
Magisk: the powerful root tool.
genuine: apk v2 signature validation.
Diamorphine: some rootkit skills.

Languages

Kotlin 67.1%

C 20%

Rust 11.1%

Shell 0.9%

Makefile 0.4%

Other 0.4%