Skip to main content

Mac

Retrieve API Key​

Log in and retrieve an API key from https://app.airpipe.io/apikeys

Permissions & Security​

On new Apple devices, gatekeeper will block the binary from running by default.

After you attempt to run it once simply with ./airpipe you will need to allow it by going to Privacy & Security scroll towards the bottom, and there will be a prompt to allow the binary.

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, fetch the binary yourself. Every release publishes a SHA-256 next to it so you can verify what you downloaded before running it.

macOS ships shasum rather than sha256sum:

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

  # Apple Silicon — for Intel Macs use x86_64 instead
  BASE="https://download.airpipe.io/${VERSION}/darwin/aarch64"

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

  shasum -a 256 -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 --api-key enter-your-api-key-12345

Gatekeeper will block it on first run — see Permissions & Security above.

Download Binary