--- layout: default title: Installation — runaway --- # Installation ## Homebrew (easiest) ```bash brew tap mateussiqueira/runaway brew install runaway ``` Or in one step: ```bash brew install mateussiqueira/runaway/runaway ``` ## Direct download ```bash 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) ```bash curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway -o /tmp/runaway chmod +x /tmp/runaway && /tmp/runaway bypass ``` ## Building from source ```bash git clone https://github.com/mateussiqueira/runaway.git cd runaway bash examples/build-standalone.sh # Output: runaway-standalone.sh (~3200 lines) ``` ## Verifying the installation ```bash ./runaway version # → runaway v2.0.0 ./runaway doctor # Runs pre-flight diagnostics ```