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.

Prerequisites​

  • macOS (amd64 or arm64) or Linux (amd64 or arm64)
  • For go install or building from source: Go 1.25 or later

Option 1: 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/rackerlabs/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 2: Install with go install​

If you have Go 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.

Option 3: Build from Source​

  1. Clone the repository:

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

  2. Build the binary:

    go build -o opencenter .

  3. Move the binary to a directory on your PATH:

    sudo mv opencenter /usr/local/bin/

Verify Installation​

opencenter version

Expected output:

opencenter version 1.0.0