Skip to main content

How to install the Ververica CLI

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

Installation via Script​

You can use a script to download the latest release or to update your current installation.

On macOS and Linux, copy and paste in your terminal:

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

On Windows, copy and paste the next code in your PowerShell terminal:

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

Installation via Homebrew​

If you're on macOS, you can use Homebrew

brew tap ververica/vvctl && brew install vvctl

Manual Installation​

You can install vvctl manually by downloading the binary.

  1. Go to the Latest Release Page in our 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 (e.g., /usr/local/bin).
  5. On Linux and macOS, ensure the binary is executable: chmod +x vvctl.

Verify the Installation​

After installing vvctl, you can verify that it's 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/hec/.config/vvctl
Data directory: /Users/hec/.local/share/vvctl

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