Kernarium
Run a real Linux kernel natively on iOS, through the magic of User-mode Linux.
Apps
Andarium
An Android emulator app built on the Kernarium runtime is available for download in App Store. Source code is available under Andarium/.
If you want, you can also sideload IPA from releases.
Kernarium
A generic Linux emulator app capable of running various Linux distributions. It's still at an early stage of development and isn't ready for release yet. Source code is available under Kernarium/.
Overview
The User-mode Linux kernel is compiled to native arm64 code, then linked to an iOS runtime framework. The kernel runs natively without emulation. Userspace programs are emulated using an iSH-style threaded interpreter, with SMP support. Guest GPU acceleration is provided by KosmicKrisp, a translation layer from Vulkan to Metal.
This emulator architecture sits between a full system emulator (like UTM) and a full userspace emulator (like iSH). It combines the benefits of a real Linux kernel and a userspace emulator that only needs to emulate userspace code. It's capable of running advanced workloads including Docker containers, Linux desktops, Wine/Proton and a full Android system at decent speed on modern iOS devices.
Features
- Kernel
- Mainline 6.18 LTS kernel for both Linux and Android guests
- Supports most kernel features, including namespaces, SELinux and more
- CPU emulation
- Supports
arm64,arm32,x86_64guest instructions - Both interpreter and JIT execution modes (interpreter-only for TestFlight release)
- Supports
- GPU acceleration
- Vulkan 1.4 via KosmicKrisp
- OpenGL 4.6 & GLES 3.2 via Zink
- Hardware video encoding and decoding (H.264, HEVC) via VideoToolbox
- Storage
- Supports virtual disks via UBD driver, with discard support
- Supports any Linux filesystem including ext2/3/4, erofs, xfs, ...
- Supports loop devices and FUSE
- Network
- Full Linux networking stack
- Guest network access via libslirp
Build or Embed
Point your coding agent at this repo if you want to build the project or embed its runtime in other apps. The agent guide is AGENTS.md, and the documentation is under docs/.
Building Android system image requires a powerful remote x86_64 Linux building machine (requirements). Alternatively, you can download prebuilt images from releases and point your coding agent at it.
License
This project is licensed under GPL-2.0-or-later, except where a file's SPDX header says otherwise; see LICENSES/.

