Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

oneamendez/crate-ios

DevOps & Self-hosting

Runs full Linux desktop VMs locally on iPhone and iPad, aimed at users willing to sideload and enable JIT.

361
15
Swift
MPL-2.0
3 days old

What it is

crate is an iOS app that boots full arm64 Linux distributions as virtual machines on an iPhone or iPad, without a remote desktop or cloud VM. The guest OS runs on the crate engine, a Rust arm64-to-arm64 translator developed in a separate repository crate engine.

The app installs Ubuntu 26.04 LTS with GNOME, Debian 13 or Arch Linux ARM with KDE Plasma or Xfce from a catalog, each with a user account created during install. Desktop rendering is GPU-accelerated through virglrenderer, ANGLE and MoltenVK; touch is treated as a tablet, and an on-screen key row supplies Esc, Ctrl, Super, Tab, function keys and arrows. iPad setups can use a mouse or trackpad, and an external monitor can serve as the VM display.

Quick start

crate needs JIT, so it cannot be distributed through the App Store. The entry point is an unsigned IPA from the releases page, which you sign with your own Apple account and install from a Mac. Follow INSTALL.md for the signing and installation steps; that document also provides a prompt for Claude Code that can perform them.

After launch, enable JIT in Settings using either StikDebug or the built-in StikJIT helper, as described in the JIT section. Then open the Install Vms tab, choose a distribution image and memory limit, and supply the account to create inside the VM. Installation downloads and checks the image, unpacks the disk and grows it to 32 GB; keep the app open while it runs. The VM appears under Home with a Start button and boots to its desktop.

Build from source

Building requires fetching pinned frameworks before generating the project:

./Scripts/fetch-frameworks.sh
./Scripts/fetch-stikjit.sh
./Scripts/fetch-crate.sh
xcodegen generate
open Crate.xcodeproj

For the Simulator, use xcodebuild with the Crate scheme and an iOS Simulator destination. In the Simulator there is no code region for JIT, so starting a VM fakes the display and console instead of executing a guest.

Constraints

  • JIT must be enabled through StikDebug or StikJIT; the IPA is unsigned and must be signed with a personal certificate and profile, with get-task-allow present.
  • VM images are built and attested by the arm64-desktop-images workflow; each image's kernel and initrd are booted from outside the disk, so a guest cannot update its own kernel.
  • Known issues include Xfce wallpapers not resizing with the screen and GNOME sometimes needing a manual resolution change for external monitors, documented in Known issues.
  • crate's own code is MPL-2.0; bundled components such as StikJIT, idevice, SwiftTerm, libslirp, GLib, MoltenVK, ANGLE, libepoxy and virglrenderer keep their own licenses, listed in THIRD_PARTY_NOTICES.md.

HotRepo's take

crate-ios was created in November 2026 and entered HotRepo's new-project list on 16 November with 361 stars, reporting 206 stars gained over roughly 24 hours from the previous day. The hourly star samples in that window rose from 101 to 361, with no all-language daily rank recorded. The repository describes a concrete implementation: the separate Rust engine, pinned third-party frameworks, attested VM images and an install workflow, which distinguishes it from catalog-only projects in the same space. The main practical consideration for readers is the sideload and JIT setup rather than the VM functionality itself.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

Hacker News

Crate: Run Linux VMs on iPhone and iPad
▲ 3 · 0 comments · November 15, 2026