Ververica DocsVerverica Docs
Docs Home
Viewing docs for
All deployments

Install vvctl

Applies toAll deployments
1 min read
On this page

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:

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

Install the latest preview:

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

Install a specific version:

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

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

BASH
1INSTALL_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:

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

Install a specific version:

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

Install the latest preview:

BASH
1iex (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:

BASH
1brew 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:

BASH
1vvctl --version

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

BASH
1❯ vvctl --version
2
3Welcome to Ververica Cloud
4API Host: https://app.ververica.cloud
5Not logged in. Please run `vvctl login`
6
7Config directory: /Users/ververica/.config/vvctl
8Data directory: /Users/ververica/.local/share/vvctl
9
102025.7.8 33afb774ae0f4a0632aefb7d44abeb7cbbc46f67 (2025-07-11)
11Ververica GmbH <help@ververica.com>
Was this helpful?