Installation

The Runway CLI is available for Linux, Mac OSX and Windows. We are still working through the logistics to offer additional native installation methods, but for the time being this is what we have.

Installation with curl

To construct your own curl one-liner to install runway (without root) to ~/.local/bin (e.g. /home/account/.local/bin), it would look similar to this:

$ curl --proto '=https' --tlsv1.2 -sSfL \
    https://download.runway.horse/runway/latest/runway_$OS_$ARCH \
    -o /tmp/runway \
    && install -m 0755 /tmp/runway ~/.local/bin/runway \
    && rm /tmp/runway

Checksums are available

https://download.runway.horse/runway/$VERSION/checksums.txt

one-liner

A ready-for-you one-liner to install of the Runway CLI is the following:

$ bash <(curl -s https://www.runway.horse/install.sh)

The install.sh script requires very little: a recent version of bash and the curl command.

Feel free to inspect the script before you run it — of course we’re open for feedback. We very much prefer the other methods mentioned on this page, or constructing the curl command yourself so you know what happened.

By default the location of the Runway CLI is: ~/.local/bin/runway. But you may adjust it by setting the RUNWAY_INSTALL_LOCATION environment variable prior to executing the script.

Download links

Linux:

https://download.runway.horse/runway/latest/runway_linux_386
https://download.runway.horse/runway/latest/runway_linux_amd64
https://download.runway.horse/runway/latest/runway_linux_arm64

Mac OSX:

https://download.runway.horse/runway/latest/runway_darwin_386
https://download.runway.horse/runway/latest/runway_darwin_amd64
https://download.runway.horse/runway/latest/runway_darwin_arm64

Windows:

https://download.runway.horse/runway/latest/runway_windows_386.exe
https://download.runway.horse/runway/latest/runway_windows_amd64.exe
https://download.runway.horse/runway/latest/runway_windows_arm64.exe

Homebrew

For Mac OSX (and Linux), we offer a homebrew tap:

$ brew tap hostwithquantum/runway
...
$ brew install hostwithquantum/runway/runway
...

nix

For Mac OSX and Linux, we offer a nix user repository (NUR):

$ export NIXPKGS_ALLOW_UNFREE=1
$ nix shell --impure 'github:hostwithquantum/nur#runway'

snap

For Linux, we offer a snap package:

sudo snap install runway-cli
sudo snap alias runway-cli.runway runway

Github Workflows

Use hostwithquantum/setup-runway and the following example workflow to get started:

on:
  pull_request:

jobs:
  demo:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
      with:
        fetch-depth: 0
    - uses: hostwithquantum/setup-runway@v0.3.0
      with:
        username: ${{ secrets.RUNWAY_USERNAME }}
        password: ${{ secrets.RUNWAY_PASSWORD }}
    - run: runway whoami

Other CI/CD systems can be integrated using one of the methods above. If you’d like to see an integration specific to another CI/CD system, please get in touch.

Company