Skip to content

Installation and Upgrade

Prerequisites

To start using Cluster.dev please make sure that you comply with the following preconditions.

Supported operating systems:

  • Linux amd64

  • Darwin amd64

Required software installed:

  • Git console client

  • Terraform

Terraform

The Cluster.dev client uses the Terraform binary. The required Terraform version is 1.4 or higher. Refer to the Terraform installation instructions to install Terraform.

Install From Script

Tip

This is the easiest way to have the Cluster.dev client installed. For other options see the Install From Sources section.

Cluster.dev has an installer script that takes the latest version of Cluster.dev client and installs it for you locally.

Fetch the script and execute it locally with the command:

curl -fsSL https://raw.githubusercontent.com/shalb/cluster.dev/master/scripts/get_cdev.sh | sh

Install From Sources

Download from release

Each stable version of Cluster.dev has a binary that can be downloaded and installed manually. The documentation is suitable for v0.4.0 or higher of the Cluster.dev client.

Installation example for Linux amd64:

  1. Download your desired version from the releases page.

  2. Unpack it.

  3. Find the Cluster.dev binary in the unpacked directory.

  4. Move the binary to the bin folder (/usr/local/bin/).

Building from source

Go version 16 or higher is required - see Golang installation instructions.

To build the Cluster.dev client from source:

  1. Clone the Cluster.dev Git repo:

    git clone https://github.com/shalb/cluster.dev/
    
  2. Build the binary:

    cd cluster.dev/ && make
    
  3. Check Cluster.dev and move the binary to the bin folder:

    ./bin/cdev --help
    mv ./bin/cdev /usr/local/bin/