Automated GitHub Actions CI/CD pipeline for compiling and distributing GKI kernels.
This repository implements a unified, config-driven build orchestration system that compiles multiple KernelSU variants across multiple kernel versions from a single workflow trigger. Each variant is encapsulated within its own isolated job, maximizing maintainability, simplifying fault isolation, and enabling seamless horizontal scaling for future variants and kernel versions.
All kernel version-specific settings are centralized in .github/config/kernel_versions.json. A single kernel_version input at workflow dispatch drives the entire build matrix — including kernel version, sublevel, compiler, Rust support, and AnyKernel3 branch selection.
Note
Kernel 6.12.23 Deprecation: Commit 650419b removed the deprecated android16-6.12-2025-06 branch from the default build matrix. If you still need this version, revert that commit (git revert 650419b). To use other kernel versions or revisions, edit .github/config/kernel_versions.json directly.
| Variant | SUSFS | Droidspaces | Hook Type |
|---|---|---|---|
| MidoriSU-KX | ❌ | ❌ | Kprobes |
| MidoriSU-KX-DS | ❌ | ✅ | Kprobes |
| MidoriSU-KX-SUSFS | ✅ | ❌ | De-inlined |
| MidoriSU-KX-SUSFS-DS | ✅ | ✅ | De-inlined |
| MidoriSU-NX | ❌ | ❌ | Tracepoint |
| MidoriSU-NX-DS | ❌ | ✅ | Tracepoint |
| MidoriSU-NX-SUSFS | ✅ | ❌ | De-inlined |
| MidoriSU-NX-SUSFS-DS | ✅ | ✅ | De-inlined |
| MidoriSU-OX | ❌ | ❌ | Kprobes |
| MidoriSU-OX-DS | ❌ | ✅ | Kprobes |
| MidoriSU-OX-SUSFS | ✅ | ❌ | De-inlined |
| MidoriSU-OX-SUSFS-DS | ✅ | ✅ | De-inlined |
| MidoriSU-RX | ❌ | ❌ | Manual |
| MidoriSU-RX-DS | ❌ | ✅ | Manual |
| MidoriSU-RX-SUSFS | ✅ | ❌ | De-inlined |
| MidoriSU-RX-SUSFS-DS | ✅ | ✅ | De-inlined |
| MidoriSU-XX | ❌ | ❌ | Branch Link |
| MidoriSU-XX-DS | ❌ | ✅ | Branch Link |
| MidoriSU-XX-SUSFS | ✅ | ❌ | De-inlined |
| MidoriSU-XX-SUSFS-DS | ✅ | ✅ | De-inlined |
* MidoriSU-RX & MidoriSU-XX Hook Type: Configured via
midorisu_rx_hook_modeandmidorisu_xx_hook_mode.
midorisu_rx_hook_mode—manual(default) /tracepointmidorisu_xx_hook_mode:
branch link hijacking— default for MidoriSU-XX; usesCONFIG_KSU_HACK_ARM64_BRANCH_LINKto scan kernel text and overwrite call-site branch instructions (b/bl) directly to hooks, bypassing trampoline overhead and complying with ARM64 CFIsyscall table tampering— usesCONFIG_KSU_TAMPER_SYSCALL_TABLEto directly tamper withsys_call_tableentries, avoiding indirect branch (blr) overhead while complying with Clang CFImanual— manually-patched hooks viascope-min-manual-hooks-v2.3.patchmidorisu_xx_kpatch_compat— withbranch link hijacking, applies the KernelPatch compatibility fixes (execve fallback and syscall table mirror skip) to MidoriSU-XX
Tip
Matrix Build Orchestration: The matrix always produces exactly 1 artifact per variant — the enabled features (Droidspaces and/or SUSFS) are applied to that single artifact. With all variants selected, this yields 4 builds per sublevel for each kernel version (MidoriSU-RX is excluded from all and is built only when selected explicitly). Choosing all from the kernel_version dropdown compiles all configured sublevels across 6.1, 6.6 and 6.12 in parallel for a total of 28 concurrent jobs.
MidoriSU is the official companion app for all MidoriSU kernel variants. Based on KowSU with extensive customizations and extensions, it offers seamless out-of-the-box compatibility across all MidoriSU variants — KX, NX, OX, RX, XX — including all SUSFS and Droidspaces combinations.
| Feature | Description |
|---|---|
| Modern Bento Dashboard | Bento-style responsive dashboard with spring-press bounce feedback; dynamically displays the KSU driver name (native driver and dynamic LKM detection), Roman numeral UAPI version, hook type, SUSFS version, Droidspaces version, Re:Kernel(-X) version, kernel build timestamp, and OEM unlock status. |
| Built-in SUSFS Management | Native SUSFS control panel in Kernel Tools that replaces the susfs4ksu module: SUS Path, SUS Kstat, SUS Map, and Open Redirect rules; kernel version (uname) and boot parameter (/proc/cmdline / bootconfig) spoofing; AVC log spoofing, SUS mount hiding, and a priority UID filter that hides selected apps from getpriority / ioprio probes. Rules are applied by ksud at boot (including a late-loaded SUSFS LKM), with a per-boot report, configuration backup and restore, and one-tap import from an existing susfs4ksu module. Works with both built-in SUSFS and susfs4ksu-lkm. |
| Dual Themes & Personalization | Supports both Material 3 Expressive and Miuix UI themes with live preview cards; includes a floating pill bottom navigation bar, tap-again-to-scroll-to-top on the active tab, module update badges, and a built-in switcher to toggle between MidoriSU, KowSU, and Official KernelSU app names, icons, and splash themes. |
| OTA Payload & ARB Analyzer | Extracts boot.img from local or online OTA zip and payload.bin archives via HTTP Range Requests without downloading entire multi-gigabyte packages; includes built-in Anti-Rollback (ARB) index and boot kernel version analysis. |
| Flashing & Safety Inspection | Direct in-app backup and flashing of boot.img, flashing AnyKernel3 zip packages with target slot selection (Slot A/B), and automated module pre-flash safety inspection to detect risky scripts and prevent bootloops. |
| Kernel Panic & Crash Analyzer | Scans /proc/last_kmsg, /sys/fs/pstore/console-ramoops*, and dmesg to pinpoint kernel panics, OOPS call traces, memory faults, and unexpected reboots. |
| Allowlist Backup & Restore | Complete backup and restoration for Superuser allowlist rules and per-app profile configurations. |
| Module Export as ZIP | Exports any installed module directly into a standard flashable ZIP archive. |
| Kernel Module (LKM) Manager | Inspects loaded kernel modules with support for dynamic loading and unloading, plus an on-boot module blocklist that prevents selected modules from loading. A kernel boot guard tolerates blocked loads to prevent bootloops, and blocking a module that first-stage modules depend on prompts for confirmation first. |
| Kernel Diagnostics | In-app inspection, searching, filtering, and sharing for /proc/kallsyms symbols, live dmesg kernel logs, and CONFIG_* kernel compile options, with a bottom-bar quick-switch widget. |
| Toggles & Integrations | Instant SELinux mode switching (Enforcing / Permissive) and KSU driver update check toggle. |
| Type | Mechanism & Characteristics |
|---|---|
Kprobes |
Dynamically instruments kernel functions at runtime via kprobe breakpoints, offering minimal kernel footprint and broad compatibility. |
Tracepoint |
Hooks into the kernel's static syscall tracepoint infrastructure (sys_enter/sys_exit) without modifying kernel source. |
Inline |
Compile-time injection via #ifdef CONFIG_KSU_SUSFS blocks embedded directly into kernel subsystem source. Uses static_key branches for runtime toggling with no reliance on kprobes or LSM hooks. Hardwired into VFS (exec, open, stat, readdir, statfs), SELinux (avc, hooks, services), input, mounts, and procfs. |
De-inlined |
Applies SUSFS hooks via kernel source patching rather than inline #ifdef CONFIG_KSU_SUSFS blocks, providing cleaner separation of SUSFS logic from core kernel subsystems. |
Manual |
Applies static kernel source patches to inject custom hooks directly into core kernel subsystems at compile time. |
Branch Link Hijacking |
Scans kernel text to overwrite call-site branch instructions (b/bl) directly to hooks without trampoline overhead. Complies with ARM64 Clang CFI. Enabled via CONFIG_KSU_HACK_ARM64_BRANCH_LINK. |
Syscall Table Tampering |
High-performance method that directly modifies function pointers in sys_call_table for sucompat and sys_reboot. Avoids indirect branch (blr) overhead and complies with Clang CFI. Enabled via CONFIG_KSU_TAMPER_SYSCALL_TABLE. |
| Feature | Description |
|---|---|
| Kernel Version | Select 6.1, 6.6, 6.12, or all to compile one or all kernel versions. Sublevel, revision, compiler, and Rust settings are auto-resolved from the centralized config. |
| Source Mirror | Choose between Google's official AOSP mirror or a self-hosted mirror for kernel source and toolchain downloads. |
| SUSFS | SUSFS kernel patches are synced from upstream automatically and generated for every supported sublevel, including pinned non-LTS revisions in kernel_versions.json. A single susfs_commit input controls SUSFS versions across variants. SUSFS is configured in MidoriSU Manager, so no separate susfs4ksu module is attached to releases. |
| KSU Toolkit | Automatically fetches the latest ksu_toolkit module from nightly.link and links it in the release notes. |
| Droidspaces | Container support via Droidspaces-OSS — SYSVIPC, IPC_NS, PID_NS, DEVTMPFS, NTSync, and networking. Controlled per-variant by the use_droidspaces toggle. |
| Re:Kernel(-X) | Integrated Re:Kernel and Re:Kernel-X compiled directly into the kernel. Provides tombstone freeze recovery, network-triggered unfreeze, and binder async cleanup. Controlled by the use_rekernel toggle. |
| VPNHide Next | Integrated VPNHide Next via in-tree kpatch (CONFIG_VPNHIDE=y), hiding VPN network interfaces, routing rules, and socket descriptors at the kernel level without relying on dynamic LKM. Links the companion vpnhide-bridge.zip module and manager APK (vpnhide.apk) from their upstream releases in the release notes. Controlled by the use_vpnhide toggle. |
| NoMount | Integrated NoMount compiled directly into the kernel (CONFIG_NOMOUNT=y), a VFS path redirection framework that injects and hides module files without creating mounts or touching /proc/mounts. Links the companion NoMount-*.zip metamodule from its upstream release in the release notes. Controlled by the use_nomount toggle. |
| fgetpriority | Integrated fgetpriority compiled directly into the kernel (CONFIG_FGETPRIORITY=y), hiding other app UIDs from getpriority / setpriority / ioprio_get / ioprio_set probes made by apps. No module installation is required. Controlled by the use_fgetpriority toggle. |
| Unicode Bypass Fix | Always enabled. Patches kernel Unicode normalization to prevent filesystem bypass attacks via non-standard Unicode encodings. |
| CVE Fixes | Always enabled. Detects CVE-2026-43499 (rtmutex), CVE-2026-64560 (sighand / POSIX CPU timers) and CVE-2026-98260 (exec / POSIX CPU timers) in the kernel source and applies the fixes when missing; the result for each sublevel is shown in the release notes. |
| Network & Filesystem | Always enabled. TCP BBRv1 (bbr) and BBRv3 (bbr3), IPSET, enhanced NAT (IPv6 NAT and REDIRECT), and TMPFS xattr / POSIX ACL. |
| TCP Congestion Control module | Each release includes a standalone Magisk / KernelSU ZIP. Its WebUI lists the algorithms registered on the device. A selection takes effect for new TCP connections and is reapplied at boot. Choose Follow system to clear it. Updates preserve the selection and use KernelSU native hot installation or live activation on compatible file-based installers. On Magisk, open the module with a KernelSU-compatible WebUI host. Controlled by the build_tcp_congestion_module toggle (off by default). |
| ADIOS I/O Scheduler | Optionally integrates ADIOS as the built-in default multi-queue I/O scheduler for kernels. Controlled by the use_adios toggle. The separate build_adios_module toggle attaches the ADIOS module to 6.6 and 6.12 releases: it loads ADIOS as an LKM on kernels without it (such as stock kernels with LKM-mode KernelSU), only manages scheduler selection when ADIOS is built in, and switches the default scheduler from its WebUI or Action button. The system scheduler is kept until another one is chosen. |
| LZ4/ZSTD ZRAM Backends | Optionally updates the kernel's LZ4 and ZSTD implementations from the official LZ4 1.10.0 and Zstandard 1.5.7 releases, with ZRAM backend support enabled for kernel 6.12 (only tested on 6.12.23). Controlled by the use_lz4_zstd toggle; 6.1 and 6.6 builds remain unchanged. |
| Ccache | Compiler cache integration with a 60-second wait guard for dependency installation, ensuring accelerated incremental rebuilds across workflow runs. |
| Spoofed Build Metadata | Customizable kernel name, build timestamp, user, and host strings for the compiled image. |
| Extra Features & Fixes | Applies the extra feature and fix commits carried on top of each MidoriSU branch to the matching variant. Controlled by the use_extra_features toggle. |
| KSU Debug | Builds with CONFIG_KSU_DEBUG=y and uploads a zstd-compressed vmlinux artifact for eBPF debugging. Controlled by the ksu_debug toggle. |
| Upstream Sync | Updates kernel versions and sources in kernel_versions.json and regenerates SUSFS patches from upstream before the build. Controlled by the sync_upstream toggle. |
| Release Type | release publishes a release and keeps the latest 2 releases per kernel version, pre-release publishes a pre-release, and no-release only uploads build artifacts. |
The following devices have been confirmed to work with kernels built by this workflow:
| Brand | Model |
|---|---|
| Pixel 7/8/9/10/11 series (Tensor) | |
| Xiaomi | Xiaomi 17 series (Snapdragon) |
| Xiaomi | REDMI K90 Pro Max (Snapdragon) |
| Xiaomi | POCO F8 Ultra (Snapdragon) |
| Tecno | Tecno Camon 40 Pro 4G (Helio) |
| Motorola | Moto Edge 70 Max (Snapdragon) |
| Lenovo | Legion Y70 2026 (Snapdragon) |
| Lenovo | Legion Y700 Infinite (Snapdragon) |
Note
Compatibility Notes:
- All listed devices run Android 16+ with GKI kernels (6.1/6.6/6.12)
- SUSFS and Droidspaces features have been tested on all device families
- Users on stock ROMs are advised to flash the kernel via MidoriSU Manager or Kernel Flasher
Tip
Have a device not listed?
If you've successfully tested a kernel on your device, feel free to open an issue or pull request to have it added to this list!