Files
runaway/docs/install.md
T
2026-11-09 10:13:51 +08:00

1.1 KiB

layout, title
layout title
default Installation — runaway

Installation

Homebrew (easiest)

brew tap mateussiqueira/runaway
brew install runaway

Or in one step:

brew install mateussiqueira/runaway/runaway

Direct download

curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o runaway
chmod +x runaway
sudo ./runaway init

From a USB drive (for Recovery mode)

  1. Format a USB/SSD as FAT32, APFS, or exFAT
  2. Copy the runaway folder (or just runaway-standalone.sh) to the drive
  3. Boot to Recovery and run from /Volumes/YourDrive/runaway

Via curl in Recovery (needs internet)

curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway -o /tmp/runaway
chmod +x /tmp/runaway && /tmp/runaway bypass

Building from source

git clone https://github.com/mateussiqueira/runaway.git
cd runaway
bash examples/build-standalone.sh
# Output: runaway-standalone.sh (~3200 lines)

Verifying the installation

./runaway version
# → runaway v2.0.0

./runaway doctor
# Runs pre-flight diagnostics