CLI Setup

The Verrazzano command-line tool, vz, is available for Linux and Mac systems. Download the binary you want from the Releases page.

Install the vz CLI

These instructions demonstrate installing the CLI on Linux AMD64 machines.

Download the latest release

 $ curl -LO https://github.com/verrazzano/verrazzano/releases/download/v1.4.8/verrazzano-1.4.8-linux-amd64.tar.gz

Validate the binary (optional)

Download the checksum file.

 $ curl -LO https://github.com/verrazzano/verrazzano/releases/download/v1.4.8/verrazzano-1.4.8-linux-amd64.tar.gz.sha256

Validate the binary against the checksum file.

 $ sha256sum -c verrazzano-1.4.8-linux-amd64.tar.gz.sha256

Unpack and copy the vz binary

 $ tar xvf verrazzano-1.4.8-linux-amd64.tar.gz

The following command needs to be run as root.

 $ sudo cp verrazzano-1.4.8/bin/vz /usr/local/bin

Test to ensure that the version you installed is up-to-date

 $ vz version

The resulting output should be similar to the following.

Version: v1.4.0
BuildDate: 2022-09-23T21:32:57Z
GitCommit: a34d6473a4296b8cfe64ad7851d1dcd0f18e9669

Use the vz CLI

Verrazzano provides a command-line tool for managing a Verrazzano environment using the Verrazzano and Kubernetes API.

Common use cases include installing, upgrading, and uninstalling Verrazzano, as well as analyzing failures in a running Verrazzano environment.

Usage information

Use the following syntax to run vz commands from your terminal window.

vz [command] [flags]

Available commands

Available Flags

These flags apply to all the commands.