Repository navigation
Releases: mxhm11cr/LinuxRunner
Release list
LinuxRunner 1.0.0
LinuxRunner 1.0.0
Linux on your iPhone.
LinuxRunner runs ARM64 Linux userspace applications and desktop environments on iOS through a custom ARM64 interpreter and Linux compatibility layer. No jailbreak, virtual machine or JIT is required.
What you can do
- Install Debian 13 ARM64 or use bundled Alpine 3.24 ARM64.
- Use a Linux terminal, user accounts,
apt,apk, compilers and scripting tools. - Open LinuxRunner Desktop or explore KDE Plasma.
- Run desktop applications including Dolphin and Konsole, with browser and Blender compatibility depending on the application and workload.
- Use Mesa software graphics and try experimental Metal acceleration for supported OpenGL paths.
Installation
- Download
LinuxRunner-1.0.0.ipafrom this release. - Install it using your preferred compatible sideloading tool, such as Sideloadly or AltStore Classic.
- Open LinuxRunner on your iPhone.
- Follow the in-app setup instructions to install a Linux environment.
The IPA is unsigned. Your chosen tool must sign it; signing requirements, refresh periods and compatibility depend on the method and account. App Group access is optional. Keep the bundle identifier and App Group configuration consistent when updating, and back up important Linux files before changing signing settings.
Important limitations
ARM64 Linux userspace is supported; x86 applications and Linux kernel boot are not. KDE Plasma and Metal graphics acceleration are experimental. Browsers, Blender and other demanding programs may encounter unsupported features or memory limits. iOS can suspend the app in the background. Linux users and permissions are not a security boundary inside the app.
The iOS deployment target is 15.0. See the README for compatibility notes and getting started.
Source and license
LinuxRunner derives from iSH through ios-linuxkit. The combined application is GPL-3.0-covered; upstream copyright notices, contribution-specific licensing and the App Store terms are preserved. Third-party components retain their own licenses.
See the v1.0.0 source, license and third-party notices.
Source and license downloads
LinuxRunner-1.0.0-source.tar.gz includes the application, pinned build dependencies,
matching Alpine package recipes and checked source inputs, and terminal renderer
sources. LICENSES.txt provides license texts and third-party notices. Use this
source asset when you need dependency contents; GitHub automatic source archives
omit submodules.
SHA256SUMS contains checksums for the IPA, source archive and license notices.
SHA-256
LinuxRunner-1.0.0.ipa — 14,496,024 bytes. Verify the downloaded IPA before signing; signing changes its checksum.
710dcf42afa27c8a0fe1928352fa4d3ecbc6a3cbbd0f6801b409d23a872a686d LinuxRunner-1.0.0.ipa