Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Rune is a tool to post-process Haiku raw ARM/ARM64 images for various physical target devices.

Build Status MIT License

Rune is generally only required to run Haiku on physical ARM/ARM64 devices. If you are emulating within qemu or another emulator, rune is not required.



  • Coordinates with a remote manifest at Github of known target boards.
  • Injects any needed vendor specific boot binaries from remote sources.
  • Writes directly to an SD card, or to a new image file.

Why is this needed?

The ARM ecosystem contains a wide range of technology and boot processes. While this variability has been great for innovation, it also means operating systems need to be custom tailored per device.

Specific boot files on SD cards, secondary loaders at specific offsets, binary vendor blobs tailored just right per SOC specifications and GPL licensed u-boot binaries make the ARM ecosystem a tricky beast to conquer.

Why Rust?

  • Low level enough to directly write to files and make modifications without relying on external tools.
  • Cross-platform. Rune is designed to be used by end-users across multiple operating systems.
  • Easy json parsing and HTTP GET's without requiring a large number of libraries.

Example Usage

  • Listing available boards: rune -l
  • Prepare an SD card for the Raspberry Pi 2: rune -b rpi2 -i haiku-arm.mmc /dev/sdc
  • Write the prepared disk image to a file: rune -b rpi2 -i haiku-arm.mmc /home/alex/haiku-arm-rpi2.mmc
  • Make an SD card bootable which has had Haiku dd'ed to it: rune -b rpi2 /dev/sdc


  • Install rust 1.26.0 or later. can be used if your distro doesn't provide.
  • cargo build --release


  • Thanks to Fedora for creating fedora-arm-installer which was the inspiration for this tool.
  • Thanks to the great Rust folks for helping out!