Installation

How to install the Polycrate CLI on Linux and macOS: via the Docker installer image or by downloading a release build from the Polycrate Hub.

Installation

Prerequisites

  • Docker (or a compatible runtime)
  • Optional: git

Current CLI version used in the examples below: 0.61.3. Newer builds come from the public Polycrate API CLI catalogue at app.ayedo.cloud — no API key. The Polycrate Hub remains a fallback while it is reachable.

List, inspect and changelog:

polycrate cli versions
polycrate cli inspect
polycrate cli changelog 0.61.3

Installation

Docker installer

Copy the binary from the image cargo.ayedo.cloud/library/polycrate to the host.

Linux amd64

export VERSION="0.61.3"
export BIN_DIR="${PWD}"
export PLATFORM="linux/amd64"

docker run --platform "${PLATFORM}" --rm -v "${BIN_DIR}":/bin_dir --entrypoint "/bin/sh" cargo.ayedo.cloud/library/polycrate:${VERSION} -c "cp /usr/local/bin/polycrate /bin_dir/."

Linux arm64

export VERSION="0.61.3"
export BIN_DIR="${PWD}"
export PLATFORM="linux/arm64"

docker run --platform "${PLATFORM}" --rm -v "${BIN_DIR}":/bin_dir --entrypoint "/bin/sh" cargo.ayedo.cloud/library/polycrate:${VERSION} -c "cp /usr/local/bin/polycrate /bin_dir/."

Once the installation has finished, run $BIN_DIR/polycrate version to verify that everything worked correctly.

Manual download (public API catalogue)

Direct download, no API key. OS/ARCH e.g. linux/amd64, linux/arm64, darwin/amd64, darwin/arm64.

export VERSION="0.61.3"
export OS="linux"
export ARCH="amd64"

curl -fsSLo polycrate "https://app.ayedo.cloud/api/v1/cli/public/releases/${VERSION}/${OS}/${ARCH}/download/"
chmod +x polycrate
./polycrate version

Latest stable version as plain text (type=plain, not format=plain):

curl -fsS "https://app.ayedo.cloud/api/v1/cli/public/releases/latest/?type=plain"

Fallback: Hub download

If the API catalogue is unreachable, Hub URLs remain valid:

export VERSION="0.61.3"
curl -fsSLo polycrate.tar.gz https://hub.polycrate.io/get/polycrate/${VERSION}/linux_amd64/polycrate_${VERSION}_linux_amd64.tar.gz
tar xvzf polycrate.tar.gz
chmod +x polycrate
./polycrate version