Install

Quick install

<!-- maintainer note: the base URL below (https://stagdb.com/adjoint) is the one thing to update at a domain move -->
$ curl -fsSL https://stagdb.com/adjoint/install.sh | sh

The script detects your OS and architecture, downloads the matching release, verifies its checksum, and installs adj to /usr/local/bin (falling back to ~/.local/bin if that isn't writable). It prints the installed version and location as it finishes.

Verify it worked:

$ adj --version
adj version v1.4.0

Manual download

Prefer to fetch the binary yourself? Download the tarball for your platform, verify it, and put adj on your PATH.

<version> is a git tag like v1.4.0; https://stagdb.com/adjoint/dl/latest.txt always holds the current release version.

$ VER=$(curl -fsSL https://stagdb.com/adjoint/dl/latest.txt)
$ curl -fsSLO "https://stagdb.com/adjoint/dl/adj_${VER}_linux_amd64.tar.gz"
$ curl -fsSLO "https://stagdb.com/adjoint/dl/SHA256SUMS"
$ grep " adj_${VER}_linux_amd64.tar.gz\$" SHA256SUMS | sha256sum -c -
adj_v1.4.0_linux_amd64.tar.gz: OK
$ tar -xzf "adj_${VER}_linux_amd64.tar.gz"
$ sudo mv adj /usr/local/bin/adj

On macOS, use shasum -a 256 -c in place of sha256sum -c.

Custom download location

If your release artifacts are mirrored somewhere other than the default location, point the installer at it with ADJ_INSTALL_BASE_URL:

$ curl -fsSL https://stagdb.com/adjoint/install.sh | ADJ_INSTALL_BASE_URL=https://mirror.example.com/adjoint/dl sh

Upgrading

There's no separate upgrade command — re-run the installer (or repeat the manual download) to fetch the current release:

$ curl -fsSL https://stagdb.com/adjoint/install.sh | sh

Staying up to date

adj checks the control plane's support policy at most once a day (piggybacking on normal command usage, not a background process) and prints a one-line notice on stderr when a newer release is available:

note: adj v0.3.1 is available (you have v0.3.0) — update: curl -fsSL https://stagdb.com/adjoint/install.sh | sh

There's nothing to opt into or configure — re-running the install one-liner above always fetches and installs the current release in place. See Client config for the endpoint behind this, and Cluster operations for the related hard version gate on adj cluster provision/deprovision.

Supported platforms

Adjoint ships native binaries for Linux and macOS on amd64 and arm64.

There's no native Windows build. On Windows, install and run adj inside WSL2 (any Linux distribution) using the Linux instructions above.

Next

Continue to Getting started: admin to provision a cluster, or Getting started: developer if someone has already invited you to an org.