{"id":93623,"url":"https://github.com/fynks/awesome-kernelsu","name":"awesome-kernelsu","description":"A curated list of KernelSU \u0026 its forks, tools, modules, and documentation","projects_count":95,"last_synced_at":"2026-09-07T10:00:32.182Z","repository":{"id":305445334,"uuid":"1021210694","full_name":"fynks/awesome-kernelsu","owner":"fynks","description":"A curated list of KernelSU \u0026 its forks, tools, modules, and documentation","archived":false,"fork":false,"pushed_at":"2026-06-09T14:40:11.000Z","size":347,"stargazers_count":67,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-07-30T05:04:26.914Z","etag":null,"topics":["android-development","android-root","apatch","custom-kernel","kernel","kernelsu","kernelsu-module","kernelsu-next","magisk","root","sukisu-ultra","wild-kernel"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fynks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-17T04:18:05.000Z","updated_at":"2026-07-27T09:29:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"3759d363-641e-4e3f-b4ef-175513e3f532","html_url":"https://github.com/fynks/awesome-kernelsu","commit_stats":null,"previous_names":["fynks/awesome-kernelsu"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fynks/awesome-kernelsu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fynks%2Fawesome-kernelsu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fynks%2Fawesome-kernelsu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fynks%2Fawesome-kernelsu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fynks%2Fawesome-kernelsu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fynks","download_url":"https://codeload.github.com/fynks/awesome-kernelsu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fynks%2Fawesome-kernelsu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36770227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-06T04:43:03.162Z","status":"online","status_checked_at":"2026-08-18T02:00:06.197Z","response_time":52,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"created_at":"2025-08-27T14:55:04.436Z","updated_at":"2026-09-07T10:00:32.182Z","primary_language":null,"list_of_lists":false,"displayable":true,"categories":["🛠️ Building from Source","Related Projects","Modules and Tools","Modules \u0026 Tools","❓ FAQ","Acknowledgments","Device Kernels","KernelSU Derivatives","Official Resources","📚 Documentation","🔧 Troubleshooting","KernelSU Variants","Prebuilt Kernels","Installation \u0026 Setup","Kernel Sources \u0026 Building","Development","Community","🔧 Installation","💬 Community","License","Getting Started","What is KernelSU?","Understanding Metamodules","Metamodules","Building from Source","Documentation","FAQs"],"sub_categories":["Device-Specific Kernel Sources","Alternative Root Solutions","🛠️ Development \u0026 Debugging","Kernel Source Repositories","Essential KernelSU Modules","Framework Modifications","Building Tools \u0026 Scripts","Management Apps","System Optimization","Root Management \u0026 Hiding","Modules \u0026 Features","✅ Safety Best Practices","Root hiding","SuKiSu-Ultra (Non-GKI Specialized)","Latest Releases \u0026 Downloads","🔨 Integration \u0026 Building","📖 Core Documentation","💡 More Questions?","Getting Help","Official KernelSU","Official Tools","📦 Module Development","🆘 Recovery \u0026 Troubleshooting","KernelSU-Next","🏆 Official GKI Builds","KernelSU-Next (Enhanced Fork)","SuKiSu-Ultra","Pre-built Images \u0026 Kernels","Device-Specific Resources","Module Development","Derivative Communities","Forums \u0026 Discussion Platforms","Root Detection \u0026 Hiding","Metamodules (Required for Module Support)","✅ Pre-Installation Checklist","WildKernels (Multi-Device)","LG Devices","Xiaomi Devices","Samsung Devices","Motorola Devices","📦 Module Managers","Official Communities","🌐 Forums \u0026 Platforms","New to KernelSU?","Key Features","Prerequisites","Available Metamodules","Wild KSU","Available metamodules","SukiSU-Ultra","OnePlus Devices","Google Pixel Devices","What is a Metamodule?","ReSukiSU","Installing Your First Metamodule"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./media/kernelsu-logo.svg\" alt=\"KernelSU Logo\" width=\"128\"/\u003e\n\n# Awesome KernelSU\n\n**A curated list of KernelSU resources: official documentation, variants, modules, tools, and device kernels.**\n\n[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)\n[![GitHub stars](https://img.shields.io/github/stars/fynks/awesome-kernelsu?style=flat-square\u0026logo=github)](https://github.com/fynks/awesome-kernelsu/stargazers)\n[![License](https://img.shields.io/github/license/fynks/awesome-kernelsu?style=flat-square)](LICENSE)\n\n\u003c/div\u003e\n\n## Contents\n\n- [What is KernelSU?](#what-is-kernelsu)\n- [Getting Started](#getting-started)\n- [Installation Modes](#installation-modes)\n- [Metamodules](#metamodules)\n- [KernelSU Variants](#kernelsu-variants)\n- [Modules \\\u0026 Tools](#modules--tools)\n- [Device Kernels](#device-kernels)\n- [Building from Source](#building-from-source)\n- [Documentation](#documentation)\n- [Community](#community)\n- [Troubleshooting](#troubleshooting)\n- [FAQs](#faqs)  \n- [License](#license)\n- [Acknowledgments](#acknowledgments)\n\n\n## What is KernelSU?\n\n**KernelSU** is a kernel-based root solution for Android. Unlike userspace tools such as Magisk, it runs inside the Linux kernel and grants root access to apps directly in kernel space.\n\n### Key Features\n\n- **Root Access Control** - Only permitted apps can access or see su; all other apps remain unaware of it\n- **Kernel-Level Isolation** - Root access operates in kernel space, preventing userspace tampering and detection\n- **Metamodule System** - Pluggable module infrastructure for systemless /system modifications\n- **Advanced Permission Control**: Granular app-level root access management with customizable profiles\n- **App Profile System**: Customizable groups, capabilities, and SELinux rules for fine-grained root privilege control\n- **Module Configuration System**: Built-in key-value store for modules to save persistent or temporary settings\n\n\u003e [!NOTE]\n\u003e Official KernelSU targets Android **GKI 2.0** devices (kernel 5.10+). Compatibility ultimately depends on the device's **KMI**, not just the kernel version- see the [installation guide](https://kernelsu.org/guide/installation.html).\n\n\n\u003cbr\u003e\n\n\u003e **Learn More**: [Comprehensive KernelSU Guide](https://awesome-android-root.zhoe.org/rooting-guides/kernelsu-guide) | [Official Documentation](https://kernelsu.org/) | [Official Module Repo](https://modules.kernelsu.org)\n\n\n## Getting Started\n\n### Prerequisites\n\nBefore installing KernelSU, ensure you have:\n- **Unlocked bootloader** (required for all installation methods)\n- **Complete data backup** (always backup before modifying your device)\n- **ADB and Fastboot tools** installed on your computer\n- **Compatible device** (check compatibility below)\n\n\u003e [!TIP]\n\u003e **New to bootloader unlocking?** Check out the comprehensive guide at [Awesome-Android-Root](https://awesome-android-root.zhoe.org/rooting-guides/how-to-unlock-bootloader)\n\n### New to KernelSU?\n\n1. **Check Compatibility**\n   -Install the [KernelSU Manager](https://github.com/tiann/KernelSU/releases/latest) and open it:\n      - `Not installed` → officially supported.\n      - `Unsupported` → you must build a kernel yourself (see [Unofficially supported devices](https://kernelsu.org/guide/unofficially-support-devices.html) and [Device Kernels](#device-kernels)).\n\n2. **Choose Installation Mode**\n   - **GKI Mode**: Replaces device kernel (universal compatibility, works on Samsung Knox)\n   - **LKM Mode**: Loads as kernel module (preserves optimizations, easy updates)\n   \u003e See [Installation Modes](#installation-modes)\n\n3. **Download Manager**\n   - Get the official Manager APK for your chosen variant (links in [Variants](#kernelsu-variants) section)\n\n4. **Install KernelSU**\n   - Follow the [installation guide](#-installation) for your chosen method\n\n5. **Install Metamodule**\n   - Required only if you use modules that modify `/system` files (e.g. `meta-overlayfs`). See [Metamodules](#metamodules).\n\n6. **Verify Installation**\n   - Open KernelSU Manager and confirm root status\n\n## Installation Modes\n\nOn GKI devices KernelSU historically supports two modes. The official guide recommends:\n\n- **LKM**- for phones.\n- **GKI**- for emulators, WSA, and Waydroid.\n\n### LKM (Loadable Kernel Module)\n\nLoads KernelSU as a kernel module without replacing the original kernel.\n\n- Keeps the stock kernel and manufacturer optimizations.\n- Updates and OTA can be done in-app (including \"install to inactive slot\").\n- Does not replace the boot partition, so it does not trigger AVB.\n- Can be temporarily uninstalled without a reboot.\n- Patches the **ramdisk**- on Android 13+ devices this means the **`init_boot`** partition, not `boot`.\n\n### GKI (Generic Kernel Image)\n\nReplaces the original kernel with a GKI image.\n\n- Works without official firmware, as long as the **KMI** matches.\n- Useful for devices where LKM cannot work (e.g. Samsung devices with KNOX enabled).\n\n\u003e [!NOTE]\n\u003e Since v3.0, official KernelSU has **dropped GKI image builds** (the [build guide](https://kernelsu.org/guide/how-to-build.html) is now archival) and recommends building the LKM with [Ylarod/ddk](https://github.com/Ylarod/ddk). Official releases ship LKM modules and the Manager, not `boot.img` files. Forks (KernelSU-Next, SukiSU-Ultra, etc.) still provide GKI builds.\n\n\u003cdetails\u003e\n\u003csummary\u003eClick here for quick comparison\u003c/summary\u003e\n\n| **GKI Mode**                            | **LKM Mode**                                |\n| --------------------------------------- | ------------------------------------------- |\n| Universal GKI device compatibility      | Preserves original kernel and optimizations |\n| Works on Samsung Knox devices           | Easy in-app updates                         |\n| Independent of firmware updates         | OTA-friendly                                |\n| Better for heavily modified devices     | No AVB/dm-verity issues                     |\n| More stable on custom ROMs              | Can disable without reboot                  |\n| Loses manufacturer kernel optimizations | Preserves manufacturer tuning               |\n| Requires manual fastboot flashing       | Requires official firmware                  |\n| Must reflash after major updates        | May not work on all devices                 |\n|                                         | Less compatible with modified firmware      |\n\n\u003c/details\u003e\u003cbr\u003e\n\n\u003e [!TIP]\n\u003e **Full instructions:** [Official installation guide](https://kernelsu.org/guide/installation.html)- including KMI and security-patch-level explanations.\n\n## Metamodules\n\nA **metamodule** is a special module that provides the module *mounting* infrastructure. Since v3.0, official KernelSU no longer mounts modules itself- it delegates mounting to a metamodule.\n\n\u003e [!IMPORTANT]\n\u003e A metamodule is needed **only for modules that modify `/system` files** (the `system` directory). Modules that only use scripts, `sepolicy`, or `system.prop` work without one. Only **one** metamodule can be installed at a time.\n\nNote the scope: metamodule-based mounting applies to **official KernelSU** (v3.0+) and **ReSukiSU**. **KernelSU-Next** and **SukiSU-Ultra** still ship built-in mounting (Magic Mount / OverlayFS).\n\n### Available metamodules\n\n| Metamodule | Mounting | Notes |\n|------------|----------|-------|\n| [**meta-overlayfs**](https://github.com/KernelSU-Modules-Repo/meta-overlayfs) | OverlayFS | **Official reference implementation**- recommended starting point. Also on the [official module repository](https://modules.kernelsu.org/module/meta-overlayfs). |\n| [**mountify**](https://github.com/backslashxx/mountify) | OverlayFS | Third-party; supports APatch/Magisk too. |\n| [**meta-hybrid_mount**](https://github.com/Hybrid-Mount/meta-hybrid_mount) | OverlayFS + Magic Mount | Third-party; dual-engine with auto-fallback (\"Hybrid Mount\"). |\n\n\n### Installing Your First Metamodule\n\n**Step-by-Step Installation:**\n\n1. **Download metamodule ZIP** from GitHub releases (meta-overlayfs recommended)\n2. **Open KernelSU Manager** \u003e Modules\n3. **Tap \"Install from storage\"** (➕ button)\n4. **Select the metamodule ZIP** file\n5. **Reboot device**\n\nThe active metamodule will be displayed in your module list with a special designation.\n\n\u003e [!TIP]\n\u003e Browse the full, current list of metamodules and modules at the **[official module repository](https://modules.kernelsu.org/)**.\n\n**Details \u0026 switching procedure:** [Official metamodule guide](https://kernelsu.org/guide/metamodule.html)\n\n\n\n## KernelSU Variants\n\n\u003e [!WARNING]\n\u003e Everything below **Official KernelSU** is a **community fork/derivative**, not an official project. Features of one variant do not apply to the others.\n\n\n### Official KernelSU\n\n[![GitHub](https://img.shields.io/badge/GitHub-tiann%2FKernelSU-blue?logo=github\u0026style=flat-square)](https://github.com/tiann/KernelSU)\n[![Documentation](https://img.shields.io/badge/Docs-kernelsu.org-green?style=flat-square)](https://kernelsu.org/)\n[![Release](https://img.shields.io/github/v/release/tiann/KernelSU?style=flat-square)](https://github.com/tiann/KernelSU/releases)\n[![Telegram](https://img.shields.io/badge/Telegram-KernelSU-blue?style=flat-square\u0026logo=telegram)](https://t.me/KernelSU)\n\n\u003e The original KernelSU implementation for modern Android devices\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003e📋 View Details\u003c/b\u003e\u003c/summary\u003e\n\n- **Target:** GKI 2.0 devices (kernel 5.10+). WSA, ChromeOS, and container-based Android are supported.\n- **Architectures:** `arm64-v8a` and `x86_64`.\n- **Module mounting:** metamodule-based (v3.0+).\n- **Non-GKI:** dropped since v1.0 (last version `v0.9.5`); the [integration guide](https://kernelsu.org/guide/how-to-integrate-for-non-gki.html) is archival.\n- **Notable changes:** seccomp+ioctl supercall (v2.0), `selinux hide` (v3.2.x), optional \"jailbreak\" mode via Magica (v3.2+).\n\n\u003e [!CAUTION]\n\u003e Recent kernel versions introduced a breaking change that can make KernelSU fail or **kernel-panic on `x86_64`**. Check the [official repository](https://github.com/tiann/KernelSU) for current status.\n\n**Resources:**\n- [Download Manager APK](https://github.com/tiann/KernelSU/releases/latest)\n- [Official Documentation](https://kernelsu.org/)\n- [Official Module Repository](https://modules.kernelsu.org)\n- [Telegram Channel](https://t.me/KernelSU)\n- [Report Issues](https://github.com/tiann/KernelSU/issues)\n\n\u003c/details\u003e\n\n\n### KernelSU-Next\n\n\n[![GitHub](https://img.shields.io/badge/GitHub-KernelSU--Next-blue?logo=github\u0026style=flat-square)](https://github.com/KernelSU-Next/KernelSU-Next)\n[![Documentation](https://img.shields.io/badge/Docs-kernelsu--next.github.io-green?style=flat-square)](https://kernelsu-next.github.io/webpage/)\n[![Release](https://img.shields.io/github/v/release/KernelSU-Next/KernelSU-Next?style=flat-square)](https://github.com/KernelSU-Next/KernelSU-Next/releases)\n[![Telegram](https://img.shields.io/badge/Telegram-KernelSU__Next-blue?style=flat-square\u0026logo=telegram)](https://t.me/KernelSU_Next)\n\n\u003e Enhanced fork with extended compatibility, modern UI, and innovative features.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📋 View Details\u003c/b\u003e\u003c/summary\u003e\n\n- **Kernel support:** 4.4–6.6 (non-GKI 4.x–5.4 LTS; GKI 5.10–6.6; 6.6+ experimental).\n- **Module mounting:** built-in **Magic Mount + OverlayFS**, switchable from settings.\n- **Features:** module backup \u0026 restore, auto-updates, bulk install, hide hosts (unmount), SuSFS controls, SU-allowlist backup.\n- **Architectures:** `arm64-v8a`, `armeabi-v7a`, `x86_64` (same `x86_64` panic caveat as upstream).\n- **Community device list:** [Unofficially supported devices](https://kernelsu-next.github.io/webpage/pages/devices.html)\n\n**Resources:**\n- [Download Manager APK](https://github.com/KernelSU-Next/KernelSU-Next/releases)\n- [Official Website](https://kernelsu-next.github.io/webpage/)\n- [Supported Devices](https://kernelsu-next.github.io/webpage/pages/devices.html)\n- [Telegram Community](https://t.me/KernelSU_Next)\n- [Report Issues](https://github.com/KernelSU-Next/KernelSU-Next/issues)\n\n\u003c/details\u003e\n\n### SukiSU-Ultra\n\n[![GitHub](https://img.shields.io/badge/GitHub-SukiSU--Ultra-blue?logo=github\u0026style=flat-square)](https://github.com/SukiSU-Ultra/SukiSU-Ultra)\n[![Documentation](https://img.shields.io/badge/Docs-sukisu.org-green?style=flat-square)](https://sukisu.org/)\n[![Release](https://img.shields.io/github/v/release/SukiSU-Ultra/SukiSU-Ultra?style=flat-square)](https://github.com/SukiSU-Ultra/SukiSU-Ultra/releases)\n[![Telegram](https://img.shields.io/badge/Telegram-SukiKSU-blue?style=flat-square\u0026logo=telegram)](https://t.me/Sukiksu)\n\n\n\u003e Kernel-based root solution with KPM support, built-in SUSFS, and broad GKI/non-GKI compatibility.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📋 View Details\u003c/b\u003e\u003c/summary\u003e\n\n\n- **Kernel support:** non-GKI 4.4+; GKI 5.10+; 3.x (3.4–3.18) experimental.\n- **Module mounting:** built-in **Magic Mount**.\n- **KPM** (Kernel Patch Module) support- run code in kernel space (based on KernelPatch).\n- **SUSFS** management built into the Manager (the kernel still needs SUSFS patches).\n- **Architectures:** `arm64-v8a`, `armeabi-v7a` (bare), `x86_64` (some).\n\n**Resources:**\n- [Download Manager APK](https://github.com/SukiSU-Ultra/SukiSU-Ultra/releases)\n- [Official Website](https://sukisu.org/)\n- [Installation Guide](https://sukisu.org/guide/installation)\n- [Telegram Group](https://t.me/Sukiksu)\n\n\u003c/details\u003e\n\n### ReSukiSU\n\n[![GitHub](https://img.shields.io/badge/GitHub-ReSukiSU-blue?logo=github\u0026style=flat-square)](https://github.com/ReSukiSU/ReSukiSU)\n[![Release](https://img.shields.io/github/v/release/ReSukiSU/ReSukiSU?style=flat-square)](https://github.com/ReSukiSU/ReSukiSU/releases)\n\n\u003e A newer fork of SukiSU-Ultra focused on multi-manager support and a metamodule-based module system.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📋 View Details\u003c/b\u003e\u003c/summary\u003e\n\n- **Module mounting:** metamodule-based.\n- **Multi-manager:** works with the KernelSU, MKSU, RKSU, and SukiSU managers.\n- **Kernel support:** GKI 2.0 (5.10+); 3.4+ with manual build.\n- **Releases:** pre-release/CI builds so far (latest tag `v4.2.0-rc1`)- check the repository.\n\n**Resources:**\n- [Download Manager APK](https://github.com/SukiSU-Ultra/SukiSU-Ultra/releases)\n- [Official Website](https://sukisu.org/)\n- [Installation Guide](https://sukisu.org/guide/installation)\n- [Telegram Group](https://t.me/Sukiksu)\n\n\u003c/details\u003e\n\n### Wild KSU- archived\n\n\u003e [!NOTE]\n\u003e The **Wild KSU** fork ([WildKernels/Wild_KSU](https://github.com/WildKernels/Wild_KSU)) is **archived** (last release v3.1.2). It is no longer maintained as a root variant. The **WildKernels** team still ships KernelSU/SUSFS device kernels- see [Device Kernels](#device-kernels).\n\n### Comparison\n\n| Feature                   | Official KernelSU             | KernelSU-Next                  | SukiSU-Ultra                                     | ReSukiSU               |\n| ------------------------- | ----------------------------- | ------------------------------ | ------------------------------------------------ | ---------------------- |\n| **Status**                | Official, active              | Active fork                    | Active fork                                      | Active fork            |\n| **Kernel support**        | GKI 2.0 (5.10+); 4.14+ manual | 4.4–6.6                        | 5.10+ GKI; 4.4+ non-GKI/manual; 3.x experimental | 5.10+ GKI; 3.4+ manual |\n| **Android version**       | 12+ (GKI); 10+ community      | 9+                             | 7+                                               | 7+                     |\n| **Module mounting**       | Metamodule (3.0+)             | Metamodule + dual mount toggle | Magic Mount / Metamodule                         | Metamodule             |\n| **KPM**                   | ❌                             | ❌                              | ✅                                                | ✅                      |\n| **SUSFS**                 | Via kernel patch              | Via kernel patch               | Built-in management                              | Built-in management    |\n| **Multi-manager**         | ❌                             | ❌                              | ❌                                                | ✅ (KSU/RKSU/MKSU/Suki) |\n| **Architectures**         | arm64, x86_64                 | arm64, arm, x86_64             | arm64, arm, x86_64 (some/partial)                | arm64, arm, x86_64     |\n| **Installation modes**    | LKM (GKI image deprecated)    | GKI / LKM                      | GKI / LKM                                        | GKI / LKM              |\n| **Module backup/restore** | ❌                             | ✅                              | ❌                                                | ❌                      |\n| **Auto updates**          | ⚠️ LKM only                   | ✅                              | ⚠️ Manual                                        | ⚠️ Manual              |\n| **Root hiding**           | Metamodule-based              | Advanced (unmount)             | SUSFS built-in                                   | SUSFS built-in         |\n| **UI/UX**                 | Material 3 + Magica           | Material You                   | Enhanced + WebUI                                 | Enhanced               |\n| **Legacy support**        | ❌                             | ⚠️ Limited                     | ✅ Extensive                                      | ✅ Extensive            |\n| **Best for**              | Modern devices                | Power users                    | KPM / legacy / hiding                            | Multi-manager setups   |\n\n\u003e [!NOTE]\n\u003e SUSFS is a **separate** kernel-patch addon ([gitlab.com/simonpunk/susfs4ksu](https://gitlab.com/simonpunk/susfs4ksu))- it is not part of KernelSU itself. \"Built-in management\" means the Manager can control SUSFS on a SUSFS-patched kernel; it does not bundle the kernel patches.\n\n\n### Which Variant Should You Choose?\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"25%\" valign=\"top\"\u003e\n\n**Choose Official KernelSU if:**\n\n✅ Modern device (2021+)\u003cbr\u003e\n✅ GKI 2.0 support\u003cbr\u003e\n✅ Want maximum stability\u003cbr\u003e\n✅ Prefer official support\u003cbr\u003e\n✅ OTA compatibility priority\n\n\u003c/td\u003e\n\u003ctd width=\"25%\" valign=\"top\"\u003e\n\n**Choose KernelSU-Next if:**\n\n✅ Kernel 4.4–6.6\u003cbr\u003e\n✅ Want latest features\u003cbr\u003e\n✅ Prefer modern UI\u003cbr\u003e\n✅ Auto-updates desired\u003cbr\u003e\n✅ Advanced module mgmt\n\n\u003c/td\u003e\n\u003ctd width=\"25%\" valign=\"top\"\u003e\n\n**Choose Wild KSU if:**\n\n✅ Kernel 4.4–6.6\u003cbr\u003e\n✅ Root hiding priority\u003cbr\u003e\n✅ Want SUSFS integrated\u003cbr\u003e\n✅ Customization focused\u003cbr\u003e\n✅ Nightly build access\n\n\u003c/td\u003e\n\u003ctd width=\"25%\" valign=\"top\"\u003e\n\n**Choose SukiSU-Ultra if:**\n\n✅ Need KPM support\u003cbr\u003e\n✅ Legacy non-GKI device\u003cbr\u003e\n✅ Want built-in SUSFS\u003cbr\u003e\n✅ Banking app hiding\u003cbr\u003e\n✅ 32-bit ARM device\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## Modules \u0026 Tools\n\n\u003e The primary source for modules is the **[official module repository](https://modules.kernelsu.org/)**.\n\n### Zygisk \u0026 frameworks\n\nKernelSU has no built-in Zygisk; use a standalone implementation for Zygisk modules.\n\n- [**ZygiskNext**](https://github.com/Dr-TSNG/ZygiskNext)- standalone Zygisk implementation.\n- [**ReZygisk**](https://github.com/PerformanC/ReZygisk)- open-source, transparent Zygisk implementation.\n- [**LSPosed**](https://github.com/LSPosed/LSPosed)- Xposed framework (requires Zygisk).\n\n### Module managers\n\n- [**MMRL**](https://github.com/MMRLApp/MMRL)- modern module manager with a built-in repository, updates, backup/restore, and WebUI support.\n\n### Root hiding\n\n- [**SUSFS**](https://gitlab.com/simonpunk/susfs4ksu)- kernel patches + userspace addon providing root-hiding mechanisms (experimental; requires a SUSFS-patched kernel).\n- [**SuSFS4KSU**](https://github.com/sidex15/susfs4ksu-module)- addon root-hiding service for KernelSU.\n\n\u003e [!WARNING]\n\u003e These provide *root-hiding mechanisms* and **may improve** compatibility with apps that perform root checks. They do **not** guarantee passing Play Integrity or bypassing any given banking app, and often require additional configuration.\n\n## Device Kernels\n\nPrebuilt kernels save you from compiling. **Always verify the exact device model, Android version, kernel version, and security-patch level before flashing.**\n\n\u003e For anything not listed here, check the maintained community list of [KernelSU-Next unofficially supported devices](https://kernelsu-next.github.io/webpage/pages/devices.html), the [XDA KernelSU tag](https://xdaforums.com/tags/ksu/), or GitHub topic/search results.\n\n| Project | Devices | Notes |\n|---------|---------|-------|\n| [WildKernels- GKI](https://github.com/WildKernels/GKI_KernelSU_SUSFS) | GKI 2.0 (5.10+) devices | KernelSU + SUSFS; active |\n| [WildKernels- Sultan](https://github.com/WildKernels/Sultan_KernelSU_SUSFS) | Google Pixel | Sultan base + SUSFS; active |\n| [WildKernels- OnePlus](https://github.com/WildKernels/OnePlus_KernelSU_SUSFS) | OnePlus devices | KernelSU + SUSFS; active |\n| [WildKernels- Samsung](https://github.com/WildKernels/Samsung_KernelSU_SUSFS) | Samsung devices | KernelSU + SUSFS; active |\n| [YuzakiKokuban- Samsung](https://github.com/YuzakiKokuban) | Galaxy S23/S24/S25, Tab S10 | KernelSU kernel sources (`sm8550`, `sm8650`, `sm8750`, `mt6989`); active |\n| [KernelSU LKM- OnePlus 12](https://github.com/snowwolf725/KernelSU_LKM_For_Oneplus12) | OnePlus 12 | LKM for OxygenOS/ColorOS; active |\n| [topnotchfreaks- msm-5.15](https://github.com/topnotchfreaks/kernel_msm-5.15) | Redmi Note 12/13 4G, Redmi Pad SE, Redmi 15/POCO M7 | SukiSU-Ultra + KPM + SUSFS variants; active |\n\n**Kernel selection checklist:** exact device match · matching Android/kernel version · security-patch level (anti-rollback can brick on older patches) · active maintenance · a copy of your stock `boot.img` for recovery.\n\n## Building from Source\n\n- **Official KernelSU:** build the LKM with [Ylarod/ddk](https://github.com/Ylarod/ddk) (recommended since v3.0). The GKI and non-GKI build guides are archival- [How to build](https://kernelsu.org/guide/how-to-build.html) · [Integrate for non-GKI](https://kernelsu.org/guide/how-to-integrate-for-non-gki.html).\n- **Forks** (KernelSU-Next, SukiSU-Ultra, ReSukiSU) still support direct kernel integration- see each repository's `kernel/setup.sh`.\n- **Tools:** [AnyKernel3](https://github.com/osm0sis/AnyKernel3) (packaging/flashing) · [kernel_build_action](https://github.com/dabao1955/kernel_build_action) (GitHub Actions builds).\n- **Vendor kernel sources:** [Google](https://android.googlesource.com/kernel/) · [Xiaomi](https://github.com/MiCode/Xiaomi_Kernel_OpenSource) · [OnePlus](https://github.com/OnePlusOSS) · [Samsung](https://opensource.samsung.com).\n\n## Documentation\n\n- [What is KernelSU?](https://kernelsu.org/guide/what-is-kernelsu.html)\n- [Installation](https://kernelsu.org/guide/installation.html)\n- [Metamodules](https://kernelsu.org/guide/metamodule.html)\n- [Module guide](https://kernelsu.org/guide/module.html) · [Module WebUI](https://kernelsu.org/guide/module-webui.html) · [Module configuration](https://kernelsu.org/guide/module-config.html)\n- [App Profile](https://kernelsu.org/guide/app-profile.html)\n- [Difference with Magisk](https://kernelsu.org/guide/difference-with-magisk.html)\n- [Unofficially supported devices](https://kernelsu.org/guide/unofficially-support-devices.html)\n- [FAQ](https://kernelsu.org/guide/faq.html) · [Rescue from bootloop](https://kernelsu.org/guide/rescue-from-bootloop.html)\n\n## Community\n\n**Telegram**\n\n- [@KernelSU](https://t.me/KernelSU)- official announcements channel.\n- [@KernelSU_group](https://t.me/KernelSU_group)- official community group.\n- [@Sukiksu](https://t.me/Sukiksu)- SukiSU community.\n- [@ReSukiSU](https://t.me/ReSukiSU)- ReSukiSU community.\n\n**Other**\n\n- [GitHub Discussions](https://github.com/tiann/KernelSU/discussions) · [Issue tracker](https://github.com/tiann/KernelSU/issues)\n- [r/KernelSU](https://www.reddit.com/r/KernelSU/) on Reddit\n- [XDA Developers- KernelSU tag](https://xdaforums.com/tags/ksu/)\n\n\n## Troubleshooting\n\n\u003e [!NOTE]\n\u003e Before troubleshooting, ensure you have a backup of your stock boot image. This is crucial for recovery.\n\n### Common Issues\n\n| Issue                        | Possible Cause                        | Solution                                             |\n| ---------------------------- | ------------------------------------- | ---------------------------------------------------- |\n| **Bootloop**                 | Incompatible kernel/module            | Flash stock boot.img via fastboot, disable modules   |\n| **App Crashes**              | SELinux policy conflicts              | Check and adjust SELinux policies in app profiles    |\n| **Module Not Working**       | No metamodule installed (KSU 3.0+)   | Install a metamodule first; verify module compatibility |\n| **Root Not Detected**        | Manager not installed properly        | Reinstall KernelSU Manager, verify kernel version    |\n| **Play Integrity Failing**   | Root detection                        | Install Shamiko or SuSFS, configure hiding properly  |\n| **Update Failed**            | Insufficient storage/corrupt download | Clear cache, re-download, ensure adequate storage    |\n| **Banking Apps Not Working** | Root detection                        | Configure app profiles, install hiding modules       |\n| **System Unstable**          | Conflicting modules                   | Disable modules one by one to identify culprit       |\n\n### Emergency Recovery\n\n\u003e [!WARNING]\n\u003e If your device is in a bootloop, follow these steps immediately to restore functionality.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🚨 Click to expand: Bootloop Recovery \u0026 Emergency Procedures\u003c/b\u003e\u003c/summary\u003e\n\n#### Bootloop Recovery\n\n**Immediate Steps:**\n```bash\n# 1. Enter fastboot mode (Power + Volume Down)\n# 2. Connect device to PC\n# 3. Flash stock boot image\nfastboot flash boot stock_boot.img\n\n# 4. If needed, clear cache\nfastboot erase cache\n\n# 5. Reboot\nfastboot reboot\n```\n\n**Alternative via Recovery:**\n1. Boot into TWRP/custom recovery\n2. Flash stock boot image from recovery\n3. Wipe cache and dalvik cache\n4. Reboot system\n\n**Prevention:**\n- Always keep stock boot image backup\n- Test kernels with temporary boot first: `fastboot boot test_boot.img`\n- Create TWRP backups before major changes\n- Keep emergency download mode access available\n\n#### Module-Related Issues\n\n**Safe Mode Boot:**\n1. Create file `/data/adb/modules/.disable_modules` before boot\n2. This disables all modules for troubleshooting\n3. Remove problematic modules\n4. Delete the disable file and reboot\n\n**Commands:**\n```bash\n# Disable all modules\nadb shell su -c \"touch /data/adb/modules/.disable_modules\"\nadb reboot\n\n# Remove specific module\nadb shell su -c \"rm -rf /data/adb/modules/[module_name]\"\nadb reboot\n\n# View module logs\nadb shell su -c \"cat /data/adb/modules/[module_name]/install.log\"\n```\n\n\u003c/details\u003e\n\n### Debugging Commands\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🔍 Click to expand: Debug Commands \u0026 Diagnostics\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# Check KernelSU status\ncat /proc/version | grep KernelSU\nsu -c \"kernelsu --version\"\n\n# Kernel logs\ndmesg \u003e /sdcard/dmesg.log\ncat /proc/last_kmsg \u003e /sdcard/last_kmsg.log\n\n# KernelSU specific logs\nlogcat -s \"KernelSU\" \u003e /sdcard/kernelsu.log\nlogcat -b all \u003e /sdcard/full_logcat.log\n\n# Module installation logs\ncat /data/adb/modules/*/install.log \u003e /sdcard/module_logs.log\n\n# Check SELinux status\ngetenforce\nsestatus\n\n# List loaded modules\nls -la /data/adb/modules/\ncat /data/adb/modules/*/module.prop\n\n# Check mount points\nmount | grep overlay\nmount | grep /system\n\n# Verify root access\nsu -c \"id\"\nsu -c \"whoami\"\n\n# Check kernel config\nzcat /proc/config.gz | grep KSU\n\n# Monitor system resources\ntop -n 1\nfree -h\ndf -h\n```\n\n\u003c/details\u003e\n\n### Device-Specific Issues\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📱 Click to expand: Device-Specific Troubleshooting\u003c/b\u003e\u003c/summary\u003e\n\n#### Samsung Devices\n- **Knox Triggered**: Some Samsung devices trip Knox warranty bit (irreversible)\n- **Secure Boot**: May need to disable secure boot verification in kernel\n- **Encryption Issues**: Some kernels incompatible with Samsung encryption\n- **OEM Unlock**: Ensure OEM unlocking is enabled in Developer Options\n\n#### OnePlus Devices\n- **Fastboot Commands**: Use `fastboot oem unlock` for bootloader\n- **Generic GKI**: OnePlus devices generally do not support generic GKI builds - use manufacturer-specific kernels\n- **Anti-Rollback**: Be careful about security patch levels; flashing older kernels can brick devices\n- **Slot System**: A/B partition devices need careful slot management\n\n#### Xiaomi Devices\n- **Anti-Rollback**: Be careful with MIUI version downgrades (brick risk)\n- **Bootloader Unlock**: Xiaomi requires a waiting period via the Mi Unlock Tool\n- **MIUI Optimizations**: Some MIUI features conflict with KernelSU\n- **Vendor Mismatch**: Ensure kernel matches vendor version\n\n#### Google Pixel Devices\n- **Hardware Attestation**: Strong Play Integrity enforcement on newer Pixels\n- **Verified Boot**: Orange state warning on boot (normal)\n- **Titan M Security**: Hardware security module affects root hiding\n- **OTA Updates**: Easy to re-root after OTAs with KernelSU\n\n\u003c/details\u003e\n\n### Performance Issues\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e⚡ Click to expand: Performance Troubleshooting\u003c/b\u003e\u003c/summary\u003e\n\n#### System Slowdown\n\n**Diagnosis:**\n1. **Identify problematic modules**: Disable modules one by one\n2. **Check CPU throttling**: Monitor thermals and frequency scaling\n3. **Review I/O performance**: OverlayFS overhead on slow storage\n4. **Analyze system logs**: Look for kernel errors or warnings\n\n**Commands:**\n```bash\n# Monitor CPU usage\ntop -m 10\n\n# Check I/O stats\niostat -x 1 10\n\n# View thermal zones\ncat /sys/class/thermal/thermal_zone*/temp\n\n# Check for errors\ndmesg | grep -i error\nlogcat | grep -i error\n```\n\n#### Random Reboots\n\n**Troubleshooting:**\n1. **Check kernel logs**: `dmesg` and `/proc/last_kmsg`\n2. **Monitor memory usage**: Look for OOM (Out Of Memory) killer activity\n3. **Verify hardware stability**: Stress test without KernelSU\n4. **Test minimal config**: Remove all modules temporarily\n\n\u003c/details\u003e\n\n### App Compatibility\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🏦 Click to expand: Banking \u0026 Gaming App Compatibility\u003c/b\u003e\u003c/summary\u003e\n\n#### Banking/Payment Apps\n\n**Solutions:**\n1. **Configure app profiles**: Restrict root access for sensitive apps\n2. **Enable advanced hiding**: Install SuSFS or Shamiko modules\n3. **Check Play Integrity**: Use Play Integrity API tester\n4. **Hardware attestation**: Some devices use hardware-based detection (harder to bypass)\n\n**Recommended Setup:**\n```bash\n# Install hiding modules\n# 1. Install Shamiko module\n# 2. Install SuSFS4KSU module\n# 3. Configure DenyList in manager\n# 4. Reboot device\n# 5. Test with Play Integrity checker\n```\n\n#### Game Apps\n\n**Anti-cheat Detection:**\n- Some games detect root and ban accounts\n- Use hiding modules carefully\n- Configure app profiles to deny root access\n- Consider using non-rooted profiles for gaming\n\n\u003c/details\u003e\n\n### Getting Help\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e💬 Click to expand: Support Resources \u0026 Log Collection\u003c/b\u003e\u003c/summary\u003e\n\n#### Information to Provide\n\nWhen seeking help, include:\n1. **Device Information**: Model, Android version, kernel version\n2. **KernelSU Variant**: Official, Next, Wild KSU, or SukiSU-Ultra + version number\n3. **Installation Method**: How you installed KernelSU\n4. **Metamodule**: Which metamodule is installed (KernelSU 3.0+)\n5. **Reproduction Steps**: Detailed steps to reproduce the issue\n6. **Logs**: Relevant log files (dmesg, logcat, module logs)\n7. **Module List**: All installed modules and versions\n\n#### Log Collection Script\n\n```bash\n#!/system/bin/sh\n# Collect comprehensive logs for troubleshooting\n\nLOGDIR=\"/sdcard/kernelsu_logs_$(date +%Y%m%d_%H%M%S)\"\nmkdir -p \"$LOGDIR\"\n\n# System info\ngetprop \u003e \"$LOGDIR/system_props.txt\"\nuname -a \u003e \"$LOGDIR/kernel_info.txt\"\ncat /proc/version \u003e \"$LOGDIR/kernel_version.txt\"\n\n# KernelSU info\nsu -c \"kernelsu --version\" \u003e \"$LOGDIR/kernelsu_version.txt\" 2\u003e\u00261\n\n# Logs\ndmesg \u003e \"$LOGDIR/dmesg.log\"\nlogcat -d \u003e \"$LOGDIR/logcat.log\"\ncat /proc/last_kmsg \u003e \"$LOGDIR/last_kmsg.log\" 2\u003e/dev/null\n\n# Module info\nls -laR /data/adb/modules \u003e \"$LOGDIR/modules_list.txt\"\ncat /data/adb/modules/*/module.prop \u003e \"$LOGDIR/modules_props.txt\" 2\u003e/dev/null\n\n# Mount info\nmount \u003e \"$LOGDIR/mount_points.txt\"\ndf -h \u003e \"$LOGDIR/disk_usage.txt\"\n\necho \"Logs collected in: $LOGDIR\"\n```\n\n\u003c/details\u003e\n\n#### Support Priority\n\n1. **Official Documentation**: Check [kernelsu.org](https://kernelsu.org/) FAQ\n2. **GitHub Discussions**: Search existing issues and discussions\n3. **Telegram Groups**: Ask in appropriate variant-specific group\n4. **XDA Forums**: Device-specific threads\n5. **Reddit**: r/KernelSU for general questions\n\n\u003cdiv align=\"right\"\u003e\n\u003ca href=\"#awesome-kernelsu\"\u003e⬆ Back to Top\u003c/a\u003e\n\u003c/div\u003e\u003cbr\u003e\n\n---\n\n## FAQs\n\n**Frequently asked questions about KernelSU - Quick answers to common queries.**\n\n### General Questions\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cb\u003eWhat is a Metamodule and why do I need one?\u003c/b\u003e\u003c/summary\u003e\n\n**From KernelSU 3.0+**, the built-in module mounting system was removed. A **metamodule** is now required to provide module mounting infrastructure.\n\n**Why this change?**\n- **Reduced detection**: KernelSU itself doesn't mount modules, making it harder to detect\n- **Flexibility**: Choose your preferred mounting method (OverlayFS, Magic Mount, Hybrid)\n- **Stability**: Core KernelSU remains stable while mounting systems evolve\n\n**Quick Start:**\n1. Download [meta-overlayfs](https://github.com/KernelSU-Modules-Repo/meta-overlayfs) (recommended for beginners)\n2. Install via KernelSU Manager \u003e Modules\n3. Reboot device\n4. Now you can install regular modules\n\nSee [Understanding Metamodules](#understanding-metamodules) for complete details.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhat is KernelSU and how does it differ from Magisk?\u003c/b\u003e\u003c/summary\u003e\n\nKernelSU is a **kernel-based root solution** operating in kernel space, while Magisk operates in userspace.\n\n**Key Differences:**\n\n| Aspect | KernelSU | Magisk |\n|--------|----------|--------|\n| **Architecture** | Kernel-level | Userspace |\n| **Security** | Superior isolation | Good but less isolated |\n| **Module System** | Metamodule-based (3.0+) | Magic Mount (built-in) |\n| **Installation** | GKI / LKM modes | Boot patching |\n| **Compatibility** | Requires compatible kernel | Universal |\n| **Future-proof** | Built for modern Android | Legacy support focus |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhich installation mode should I use: GKI or LKM?\u003c/b\u003e\u003c/summary\u003e\n\n**Choose based on your device and needs:**\n\n**LKM Mode (Recommended for most):**\n- ✅ Keeps manufacturer kernel optimizations\n- ✅ Easy updates via app\n- ✅ OTA-friendly\n- ✅ Works with stock firmware\n- ⚠️ Requires official firmware\n\n**GKI Mode:**\n- ✅ Universal compatibility\n- ✅ Works on Samsung Knox devices\n- ✅ Better for custom ROMs\n- ⚠️ Loses manufacturer optimizations\n- ⚠️ Manual updates required\n\nSee [Installation Modes](#installation-modes) for detailed comparison.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhich KernelSU variant should I use?\u003c/b\u003e\u003c/summary\u003e\n\n**Quick Selection Guide:**\n\n- **Modern devices** (Android 12+, kernel 5.10+) → **Official KernelSU**\n- **Mid-range devices** (Android 9–11, kernel 4.4–6.6) → **KernelSU-Next**\n- **Root hiding focus** (Android 9+, kernel 4.4–6.6) → **Wild KSU**\n- **KPM / legacy / built-in SUSFS** (Android 7+, broad kernel support) → **SukiSU-Ultra**\n- **Multi-manager / SukiSU ecosystem** → **ReSukiSU**\n\nSee [KernelSU Variants](#kernelsu-variants) for detailed comparison.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eIs KernelSU safer than Magisk?\u003c/b\u003e\u003c/summary\u003e\n\n**Yes, in several ways:**\n\n- ✅ Kernel-level operation prevents userspace attacks\n- ✅ App Profile system for granular permission control\n- ✅ Zero system modification maintains integrity\n- ✅ Hardware security integration (ARM TrustZone)\n- ✅ seccomp + ioctl hooks (v2.0+) eliminate many side-channel detection vectors\n- ✅ Metamodule architecture reduces detection surface\n\nHowever, both are safe when properly configured.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCan I use Magisk modules with KernelSU?\u003c/b\u003e\u003c/summary\u003e\n\n**Compatibility varies:**\n\n| Module Type | Compatibility |\n|-------------|---------------|\n| **Simple modules** | ✅ Most work without changes (with metamodule) |\n| **Complex modules** | ⚠️ May need adaptation for metamodule system |\n| **Zygisk modules** | ⚠️ Require ZygiskNext or ReZygisk |\n| **Hardware-specific** | ✅ Usually compatible |\n\n**Remember**: You must install a [metamodule](#understanding-metamodules) first for any modules to work on KernelSU 3.0+.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWill KernelSU break OTA updates?\u003c/b\u003e\u003c/summary\u003e\n\n**Generally no:**\n\n- ✅ System partition remains unmodified\n- ⚠️ Boot partition may need re-patching after OTA\n- ✅ LKM mode has OTA survival features (install to inactive slot before rebooting)\n- ⚠️ Manual re-installation may be required for major updates\n\nAlways keep your patched boot image backup!\n\n\u003c/details\u003e\n\n---\n\n### Installation \u0026 Setup\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhat changed in KernelSU 3.0 and how does it affect me?\u003c/b\u003e\u003c/summary\u003e\n\n**Major Changes in KernelSU 3.0+:**\n\n1. **⚠️ Module mounting removed from core**: Fresh installations now require a [metamodule](#understanding-metamodules) for modules to work\n2. **⚠️ Official GKI image mode dropped**: Build LKM with [Ylarod/ddk](https://github.com/Ylarod/ddk); the GKI build guide is archival (forks still ship GKI builds)\n3. **📦 Official module repository**: Verified, security-reviewed modules at [modules.kernelsu.org](https://modules.kernelsu.org)\n4. **🛡️ Reduced detection surface**: seccomp + ioctl hooks (v2.0) plus metamodule architecture make detection harder\n5. **🪄 Magica jailbreak mode (v3.2+)**: Optional deeper system access\n6. **🔧 Flexible mounting**: Choose between OverlayFS, Magic Mount, or hybrid metamodules\n\n**What you need to do:**\n- **Fresh installations**: Must install a metamodule before modules will work\n- **Existing installations**: Continue to work normally (no action needed)\n- **Upgrading**: May need to install a metamodule if modules stop working\n\n**Recommended metamodule**: [meta-overlayfs](https://github.com/KernelSU-Modules-Repo/meta-overlayfs) for most users\n\nSee [Understanding Metamodules](#understanding-metamodules) for complete details.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I check if my device is compatible?\u003c/b\u003e\u003c/summary\u003e\n\n**Check your kernel version:**\n\n```bash\n# Via ADB\nadb shell uname -r\n\n# On device terminal\nuname -r\n```\n\nThen refer to the [Compatibility Matrix](#compatibility-check) to find the right variant.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eDo I need to uninstall Magisk before installing KernelSU?\u003c/b\u003e\u003c/summary\u003e\n\n**Yes, strongly recommended:**\n\n1. ✅ Uninstall all Magisk modules\n2. ✅ Uninstall Magisk completely\n3. ✅ Flash stock boot image\n4. ✅ Then install KernelSU\n\nThey will conflict if installed together.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCan I have both Magisk and KernelSU installed?\u003c/b\u003e\u003c/summary\u003e\n\n**No.** They modify the boot process differently and will conflict. Choose one solution for your device.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I backup before installing?\u003c/b\u003e\u003c/summary\u003e\n\n**Essential backups:**\n\n1. 💾 Full TWRP backup (if available)\n2. 💾 Backup stock boot.img (critical!)\n3. 📝 Document installed modules\n4. 💾 Export app data\n5. 💾 Save important files to external storage\n\n\u003c/details\u003e\n\n---\n\n### Modules \u0026 Features\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhere can I find KernelSU modules?\u003c/b\u003e\u003c/summary\u003e\n\n**Top Sources:**\n\n- [**MMRL**](https://github.com/MMRLApp/MMRL) - Modern module manager with repository\n- [**Awesome Android Root**](https://awesome-android-root.pages.dev/android-root-apps/?filters=%5BK%5D) - Curated collection\n- **GitHub** - Search \"kernelsu module\"\n- **Telegram** - Community-shared modules\n- **XDA Forums** - Device-specific modules\n\n**⚠️ Remember**: For KernelSU 3.0+ fresh installations, you must first install a [metamodule](#understanding-metamodules) before regular modules will work!\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eMy modules aren't working after installing KernelSU 3.0+, why?\u003c/b\u003e\u003c/summary\u003e\n\n**You need a metamodule!**\n\nKernelSU 3.0+ removed built-in module mounting. Fresh installations require a metamodule to provide mounting infrastructure.\n\n**Solution:**\n1. Download [meta-overlayfs](https://github.com/KernelSU-Modules-Repo/meta-overlayfs) (recommended)\n2. Install via KernelSU Manager \u003e Modules\n3. Reboot device\n4. Now regular modules will work\n\nSee [Understanding Metamodules](#understanding-metamodules) for details and alternatives.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCan I switch between different metamodules?\u003c/b\u003e\u003c/summary\u003e\n\n**Yes, but with caution:**\n\n⚠️ Only ONE metamodule can be active at a time.\n\n**To switch:**\n1. Uninstall all regular modules\n2. Uninstall current metamodule\n3. Reboot device\n4. Install new metamodule\n5. Reboot again\n6. Reinstall regular modules\n\n**Popular choices:**\n- **meta-overlayfs**: Official, recommended for most\n- **mountify**: Advanced, cross-platform support\n- **meta-hybrid_mount**: Maximum compatibility with auto-fallback\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhat are App Profiles and how do I use them?\u003c/b\u003e\u003c/summary\u003e\n\n**App Profiles** provide granular root permission control:\n\n- ⚙️ Custom UID/GID assignment\n- 🔒 Capability restrictions\n- 🛡️ SELinux context customization\n- ⏰ Time-based access control\n- 🔐 Namespace isolation\n\nConfigure in KernelSU Manager under each app's settings.\n\nLearn more: [App Profile System Guide](https://awesome-android-root.pages.dev/rooting-guides/kernelsu-guide#app-profile-system)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhat is KPM (Kernel Patch Module) in SukiSU-Ultra?\u003c/b\u003e\u003c/summary\u003e\n\n**KPM** allows running code directly in kernel space, similar to Loadable Kernel Modules (LKM). It provides the ability to do inline-hook and syscall-table-hook in kernel space - capabilities not available in other KernelSU variants. This is an exclusive feature of SukiSU-Ultra.\n\nEnable it by setting `CONFIG_KPM=y` when building the kernel.\n\n\u003c/details\u003e\n\n---\n\n### Troubleshooting\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eMy device is in bootloop, what do I do?\u003c/b\u003e\u003c/summary\u003e\n\n**Emergency recovery:**\n\n```bash\n# 1. Enter fastboot mode (Power + Volume Down)\n# 2. Connect to PC\n# 3. Flash stock boot image\nfastboot flash boot stock_boot.img\n\n# 4. Reboot\nfastboot reboot\n```\n\n**This is why you ALWAYS keep a stock boot.img backup!**\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eBanking apps aren't working, how do I fix this?\u003c/b\u003e\u003c/summary\u003e\n\n**Root hiding setup:**\n\n1. Install **Shamiko** or **SuSFS** module\n2. Configure **DenyList** in KernelSU Manager\n3. Add banking apps to DenyList\n4. Hide KernelSU Manager app\n5. Test with Play Integrity checker\n\nSee [Troubleshooting](#-troubleshooting) for detailed steps.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I verify KernelSU is working?\u003c/b\u003e\u003c/summary\u003e\n\n**Quick verification:**\n\n```bash\n# Check kernel\ncat /proc/version | grep KernelSU\n\n# Test root\nsu -c \"id\"\n\n# Or open KernelSU Manager and check status\n```\n\n\u003c/details\u003e\n\n\n## Contributing\n\nContributions are welcome- new tools, modules, maintained device kernels, and documentation fixes. See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Disclaimer\n\nRooting and kernel modification can void warranties, brick devices, and expose security vulnerabilities. This list is provided for **educational and informational purposes only**- you assume all risks.\n\nKernelSU and its derivatives are independent, community-driven projects. They are not affiliated with or endorsed by Google, Android, or any device manufacturer.\n\n\n### Legal \u0026 Safety Information\n\n**Educational Purpose Only**\n\nThis documentation is provided for **educational and informational purposes only**. Users are solely responsible for:\n\n- Understanding and complying with local laws\n- Following device warranty terms\n- Maintaining device security\n- Device modifications and consequences\n\n**No Warranty or Liability**\n\nContributors and maintainers are **NOT liable** for:\n\n- Device damage or bricking\n- Data loss or corruption\n- Warranty violations\n- Legal consequences\n- Security vulnerabilities\n\n---\n\n### Safety Best Practices\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🛡️ Click to expand: Essential Safety Guidelines\u003c/b\u003e\u003c/summary\u003e\n\n**Always Do:**\n\n| Action | Why It Matters |\n|--------|----------------|\n| ✅ **Create complete backups** | Essential for recovery |\n| ✅ **Read documentation thoroughly** | Understand before acting |\n| ✅ **Test on non-critical devices** | Avoid daily driver risks |\n| ✅ **Keep stock firmware** | Emergency recovery option |\n| ✅ **Research device-specific issues** | Know your device limitations |\n| ✅ **Understand security implications** | Protect your data |\n\n**Never Do:**\n\n| Action | Risk |\n|--------|------|\n| ❌ **Proceed without backups** | Irreversible data loss |\n| ❌ **Grant root to untrusted apps** | Security compromise |\n| ❌ **Install unknown modules** | Malware/instability |\n| ❌ **Ignore security warnings** | Serious vulnerabilities |\n| ❌ **Modify without understanding** | System damage |\n\n\u003c/details\u003e\u003cbr\u003e\n\n\u003e [!IMPORTANT]\n\u003e KernelSU and its derivatives are **independent, community-driven projects**. They are not affiliated with, endorsed by, or connected to Google, Android, device manufacturers, or any other commercial entities.\n\n---\n\n## License\n\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE)\n\n**This project is licensed under the [MIT License](LICENSE).**\n\n---\n\n## Acknowledgments\n\n**Special thanks to all contributors who made KernelSU possible.**\n\n**Project Creators**\n\n- [**tiann**](https://github.com/tiann) - Creator of KernelSU, visionary behind kernel-based root solutions\n- [**topjohnwu**](https://github.com/topjohnwu) - Magisk creator, inspiration for systemless modifications\n\n**Derivative Maintainers**\n\n- **KernelSU-Next Team** - Enhanced fork development and innovation\n- **Wild KSU Team (WildKernels)** - Customization and root hiding focused fork\n- **SukiSU-Ultra Team** - KPM integration, legacy device support and compatibility\n- **ReSukiSU Team** - Multi-manager support and metamodule integration\n\n**Community Contributors**\n\n- Module developers creating useful tools\n- Documentation translators and writers\n- Community moderators and support staff\n- Everyone who shares knowledge\n\n**Special Recognition**\n\n- All kernel developers maintaining device-specific builds\n- Community members providing support\n- Contributors to this awesome list\n\n---\n\n**Made with ❤️ by the KernelSU Community**\n\n\u003csub\u003eLast Updated: August 2026 | Maintained by [Fynks](https://github.com/fynks)\u003c/sub\u003e\n\n\u003cbr\u003e\n\n**[⬆ Back to Top](#awesome-kernelsu)**\n\n\u003c/div\u003e\n","projects_url":"https://awesome.ecosyste.ms/api/v1/lists/fynks%2Fawesome-kernelsu/projects"}