Skip to main content

Linux

Install the airpipe command​

  curl -fsSL https://download.airpipe.io/install.sh | sh

Installs the latest release for this machine (x86_64 or ARM) after checking its SHA-256, into /usr/local/bin, or ~/.local/bin when that would need a password it cannot ask for. It installs no service and needs no API key: sign in with airpipe login, then run airpipe server --config-dir ./configs. To install a particular version, or somewhere else:

  curl -fsSL https://download.airpipe.io/install.sh | AIRPIPE_VERSION=3.23.1 AIRPIPE_INSTALL_DIR=~/bin sh

To run Air Pipe as a service that starts at boot, use setup.sh below instead.

Retrieve API Key​

Log in and create an API key at https://app.airpipe.io/apikeys. It is shown once, when you create it, so copy it then (lost it? create a new one and delete the old)

You have several deployment/setup options depending on your requirements.

Setup with systemd​

  curl -s https://download.airpipe.io/setup.sh | sudo bash -s -- --api-key enter-your-api-key-12345

This will automatically setup the necessary folders and airpipe.service script.

Download the binary to the current directory​

  curl -s https://download.airpipe.io/setup.sh | sudo bash -s -- \
    --api-key enter-your-api-key-12345 \
    --download

Download the binary to the current directory and generate directories​

This is typically used in tutorial mode.

  curl -s https://download.airpipe.io/setup.sh | sudo bash -s -- \
    --api-key enter-your-api-key-12345 \
    --local

Download directly, without piping to a shell​

If you would rather not pipe a script into sudo bash — or your environment does not allow it — fetch the binary yourself. Every release publishes a SHA-256 next to it so you can verify what you downloaded before running it.

  # Resolve the current version
  VERSION=$(curl -sf https://download.airpipe.io/latest.version)

  # x86_64 — for ARM machines use aarch64 instead
  BASE="https://download.airpipe.io/${VERSION}/linux/x86_64"

  curl -fLO "${BASE}/airpipe"
  curl -fLO "${BASE}/airpipe.sha256"

  sha256sum -c airpipe.sha256    # expects: airpipe: OK
  chmod +x airpipe

Only run the binary once the checksum reports OK. If it does not match, the download is incomplete or has been tampered with — delete it and fetch again.

You still need an API key to start it:

  ./airpipe server --api-key enter-your-api-key-12345 --config-dir ./configs

The checksum is generated from the build artifact at release time, so it verifies the file we published rather than the file you happened to receive.

Download Binary