Skip to content

Installation

The pure CLI is distributed as a Debian package from Pure’s own apt repository, apt.pure.dev. It is a single statically linked binary with no runtime dependencies — there is no Node.js or compiler toolchain to install, because every build runs in the cloud on api.pure.dev.

Terminal window
curl -fsSL https://apt.pure.dev/install.sh | sudo sh

This trusts the signing key, registers the repository, and installs pure. Verify it:

Terminal window
pure version

If you’d rather not pipe a script to sh, run the same steps yourself.

  1. Trust the repository signing key:

    Terminal window
    sudo install -d -m 0755 /usr/share/keyrings
    curl -fsSL https://apt.pure.dev/pure.gpg \
    | sudo tee /usr/share/keyrings/pure-archive-keyring.gpg > /dev/null
  2. Add the repository (modern deb822 format):

    Terminal window
    sudo tee /etc/apt/sources.list.d/pure.sources > /dev/null <<EOF
    Types: deb
    URIs: https://apt.pure.dev
    Suites: stable
    Components: main
    Architectures: $(dpkg --print-architecture)
    Signed-By: /usr/share/keyrings/pure-archive-keyring.gpg
    EOF
  3. Install:

    Terminal window
    sudo apt update
    sudo apt install pure

The CLI ships for Debian and Ubuntu on amd64 and arm64. The compiled output is a native binary built in the cloud — see Language → OS support for the platforms your binaries can target.

Once the repository is registered, pure upgrades like any other package:

Terminal window
sudo apt update && sudo apt upgrade pure

Every command needs an API key. The CLI resolves it in this order:

  1. the --api-key <key> flag
  2. the PURE_API_KEY environment variable
  3. the key stored by pure login

The friendliest path is to log in once:

Terminal window
pure login

This verifies the key against api.pure.dev and stores it at ~/.config/pure/credentials (mode 0600). For CI, set PURE_API_KEY instead:

Terminal window
PURE_API_KEY= pure build src/main.ts

See Create an API key to mint one.