Manage Vertra Cloud from the terminal

Installation

The CLI is a single binary with no dependencies — no Node.js required.

macOS and Linux
Windows

curl -fsSL https://cli.vertracloud.app/install | sh

In PowerShell:

irm https://cli.vertracloud.app/install | iex

The installer downloads the latest release for your system and processor (x64 or ARM), verifies its SHA-256 checksum and adds the vertra command to your PATH. Open a new terminal and check it:

vertra --version

To update, run the install command again. To install a specific version, set VERTRA_VERSION (for example VERTRA_VERSION=v0.2.0) before running it. VERTRA_INSTALL_DIR changes where the binary goes (default ~/.vertracloud/bin, or %USERPROFILE%\.vertracloud\bin on Windows). You can also download the binary for your platform directly from the releases page.

Connecting your account

vertra auth login

Paste an API key created on the API keys page of the dashboard. In CI and scripts, set the VERTRA_API_KEY environment variable instead — it takes priority over the saved key.

First deploy

vertra doctor   # checks the project for problems before sending it
vertra deploy   # sends the current directory
vertra logs -f  # follows the application output live

Add --json to any command for structured output ready for automation.

​Installation

​Connecting your account

​First deploy

Installation

Connecting your account

First deploy