Skip to main content

Install vvctl

Ververica provides pre-compiled vvctl binaries for Apple Silicon, Linux x86_64, and Windows x86_64.

Install Using a Script​

You can use a script to download the latest release or update your current installation. The script also supports pinning versions and installing preview builds. Ververica recommends this method for installing vvctl on your local machine.

macOS and Linux​

To install or upgrade to the latest stable version:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ververica/vvctl/main/install.sh)"

Install the latest preview:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ververica/vvctl/main/install.sh)" -- --preview

Install a specific version:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ververica/vvctl/main/install.sh)" -- v2025.7.2

Change the destination (default /usr/local/bin):

INSTALL_DIR=$HOME/bin sh -c "$(curl -fsSL https://raw.githubusercontent.com/ververica/vvctl/main/install.sh)"`

Windows​

To install or upgrade to the latest version, copy and paste the following code into your PowerShell terminal:

Set-ExecutionPolicy Bypass -Scope Process -Force; iex (irm 'https://raw.githubusercontent.com/ververica/vvctl/main/install.ps1')

Install a specific version:

iex (irm 'https://raw.githubusercontent.com/ververica/vvctl/main/install.ps1') -Version v2025.7.2

Install the latest preview:

iex (irm 'https://raw.githubusercontent.com/ververica/vvctl/main/install.ps1') -Preview

The script picks the first writable folder in your PATH. If none are found, it falls back to $HOME\bin.

Install Using Homebrew​

On macOS, you can use Homebrew:

brew tap ververica/vvctl && brew install vvctl

Homebrew ships stable releases only. Preview builds are available via the install script.

Install Manually​

You can install vvctl manually by downloading the binary.

  1. Go to the latest release page in the public repository.
  2. Download the correct binary for your system.
  3. Extract the archive.
  4. Move the vvctl binary to a directory in your system's PATH (for example, /usr/local/bin).
  5. On Linux and macOS, ensure the binary is executable: chmod +x vvctl.

Verify the Installation​

After installing vvctl, verify that it is set up correctly by running the version command:

vvctl --version

If the installation was successful, you will see output similar to this, which shows the tool's version, build date, and configuration paths.

❯ vvctl --version

Welcome to Ververica Cloud
API Host: https://app.ververica.cloud
Not logged in. Please run `vvctl login`

Config directory: /Users/ververica/.config/vvctl
Data directory: /Users/ververica/.local/share/vvctl

2025.7.8 33afb774ae0f4a0632aefb7d44abeb7cbbc46f67 (2025-07-11)
Ververica GmbH <help@ververica.com>
On this page