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

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

Package Managers

The following package managers and ecosystems are currently supported.

Homebrew

For Mac OSX and Linux, we maintain 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 Actions

We offer an action called hostwithquantum/setup-runway to use the Runway CLI in your workflows. The following shows you how 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.5.0
      with:
        username: ${{ secrets.RUNWAY_USERNAME }}
        password: ${{ secrets.RUNWAY_PASSWORD }}
        public-key: ${{ secrets.PUBLIC_KEY }}
        private-key: ${{ secrets.PRIVATE_KEY }}
    - run: runway whoami

Others

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.

Updates

Use the package manager you used to install the Runway CLI or:

runway selfupdate