Skip to main content

Install the openCenter CLI

Purpose: For platform engineers, shows how to install the openCenter CLI on macOS or Linux using a pre-built binary, go install, or a source build with Mise.

Prerequisites​

  • macOS (amd64 or arm64) or Linux (amd64 or arm64)
  • For go install or building from source: Go 1.26.3 or later
  • For mise-based build (recommended): Mise installed

This is the primary development workflow. Mise manages all tool versions (Go, kubectl, helm, kind) and provides task runners.

  1. Clone the repository:

    git clone https://github.com/opencenter-cloud/openCenter-cli.git
    cd openCenter-cli

  2. Install tool versions via Mise:

    mise install

  3. Build the binary:

    mise run build

  4. The binary is output to ./bin/opencenter. Add it to your PATH:

    sudo cp ./bin/opencenter /usr/local/bin/

Option 2: Download a GitHub Release Binary​

Each tagged release publishes pre-built binaries for macOS and Linux.

  1. Download the binary for your platform from the GitHub Releases page:

    # Example: Linux amd64
    curl -Lo opencenter https://github.com/opencenter-cloud/openCenter-cli/releases/download/v1.0.0/opencenter-linux-amd64

  2. Make the binary executable and move it to a directory on your PATH:

    chmod +x opencenter
    sudo mv opencenter /usr/local/bin/

Option 3: Install with go install​

If you have Go 1.26.3+ installed, you can install directly from the module:

go install github.com/opencenter-cloud/opencenter-cli@v1.0.0

The binary is placed in $GOPATH/bin (or $HOME/go/bin by default). Ensure that directory is on your PATH.

Verify Installation​

opencenter version

Expected output:

opencenter version 1.0.0

Shell Completions​

Enable tab completions for your shell:

# Bash
opencenter completion bash > /etc/bash_completion.d/opencenter

# Zsh
opencenter completion zsh > "${fpath[1]}/_opencenter"

# Fish
opencenter completion fish > ~/.config/fish/completions/opencenter.fish

Next Steps​