Skip to content

Installation

The Vault CLI is a single binary. Install it using the install script for your platform.

Run the install script:

curl -fsSL https://download.veevavault.dev/cli/install.sh | bash

The script prompts for an install directory. The default is /usr/local/bin if it exists and is writable, otherwise ~/.local/bin. If the directory is not on your PATH, the script prints the export PATH=... line to add to your shell profile.

The install script automatically selects the native binary for your platform. On Linux, it picks the ARM64 binary on ARM64 machines and the x86_64 binary otherwise. The Linux x86_64 binary is statically linked and runs on older distributions.

Run the install script in PowerShell:

irm https://download.veevavault.dev/cli/install.ps1 | iex

The default install directory is %LOCALAPPDATA%\VeevaCLI. The script adds the install directory to your user PATH. Restart your terminal after installing.

vault.exe does not require the Visual C++ Redistributable.

Both scripts support the following options.

Custom install directory: Set VAULT_INSTALL_DIR before running the script:

curl -fsSL https://download.veevavault.dev/cli/install.sh | VAULT_INSTALL_DIR=~/bin bash
$env:VAULT_INSTALL_DIR = "C:\Tools\vault"; irm https://download.veevavault.dev/cli/install.ps1 | iex

Skip the install directory prompt: Pass -y (macOS/Linux) or -Yes (Windows) to install to the default directory. On Windows, a non-interactive session installs to the default directory without prompting.

curl -fsSL https://download.veevavault.dev/cli/install.sh | bash -s -- -y
& ([scriptblock]::Create((irm https://download.veevavault.dev/cli/install.ps1))) -Yes

Direct binary downloads are available from the Manual Downloads page for edge cases where the script cannot be used.

Confirm the CLI is on your PATH:

vault --version

You should see the installed version and platform printed, for example:

vault CLI 26.2.4-715 (macos/aarch64)

Run vault upgrade to upgrade the CLI to the latest version in place.

To remove the CLI binary, stored logins, and settings:

vault uninstall

You will be prompted to confirm. To skip the prompt in a non-interactive shell:

vault uninstall --yes