Installation

Install OPSd from a release bundle or via asdf.

For a first setup, the release bundle is the narrowest path. The recommended default is to install the binary into ~/.local/bin so it can be used from your PATH.

OpenTofu

OPSd renders standard OpenTofu, so this guide assumes tofu is already available on your system. See the OpenTofu installation guide if you need to install it first.

Release Bundle

OPSd ships release bundles for Linux amd64 and macOS Apple Silicon. The commands below install the current release into ~/.local/bin/opsd.

Linux amd64

mkdir -p ~/.local/bin
curl -fL -o ~/.local/bin/opsd "https://gitlab.com/OPSd-io/platform/opsd-cli/-/releases/v1.0.0/downloads/opsd_1.0.0_linux_amd64"
chmod +x ~/.local/bin/opsd

macOS Apple Silicon

mkdir -p ~/.local/bin
curl -fL -o ~/.local/bin/opsd "https://gitlab.com/OPSd-io/platform/opsd-cli/-/releases/v1.0.0/downloads/opsd_1.0.0_darwin_arm64"
chmod +x ~/.local/bin/opsd

If ~/.local/bin is not already on your PATH, add it once in your shell profile before you continue.

export PATH="$HOME/.local/bin:$PATH"

Add the same line to your shell profile if you want it to persist across new terminal sessions.

asdf

Install the asdf-opsd plugin:

asdf plugin add opsd https://gitlab.com/OPSd-io/platform/asdf-opsd.git
asdf install opsd 1.0.0
asdf global opsd 1.0.0

Verify The Install

After installation, confirm the CLI runs:

opsd version

Shell Completion

If you use shell completion, run the command for your shell:

Bash

opsd completion bash

Zsh

opsd completion zsh

Fish

opsd completion fish

Next

If you want the narrowest supported first-use flow, continue with the Quickstart.