CLI Reference

The Vesta CLI is a Go binary built with Cobra. Install it and manage your entire platform from the terminal.

Installation

cd cli && go build -o vesta . && mv vesta /usr/local/bin/

Commands

Deploy

Deploy an application to a specific environment:

vesta deploy <app-name> --tag <image-tag> --env <environment>

Examples:

vesta deploy my-app --tag v1.2.3 --env production
vesta deploy api-server --tag latest --env staging

Apps

List and manage applications:

vesta apps list
vesta apps get <app-name>
vesta apps delete <app-name>

Secrets

Manage secrets:

vesta secrets create <name> --type opaque
vesta secrets list
vesta secrets delete <name>

Builds

Monitor build progress:

vesta builds list --app <app-name>
vesta builds logs <build-id>

Pipelines

Manage deployment pipelines with multi-stage workflows:

vesta pipelines list
vesta pipelines get <pipeline-name>

Global Flags

FlagDescription
--api-urlVesta API server URL
--tokenAuthentication token
--outputOutput format (table, json, yaml)
--helpShow help for any command