Verda CLI¶

The Verda CLI is a command-line tool for managing your Verda Cloud infrastructure. It supports both interactive wizards for quick tasks and flag-based commands for scripting and automation.

Install¶

Quick install (macOS / Linux)¶

curl -sSL https://raw.githubusercontent.com/verda-cloud/verda-cli/main/scripts/install.sh | sh

Install to a custom directory:

VERDA_INSTALL_DIR=~/.local/bin curl -sSL https://raw.githubusercontent.com/verda-cloud/verda-cli/main/scripts/install.sh | sh

Homebrew (macOS / Linux)¶

brew install verda-cloud/tap/verda-cli

Scoop (Windows)¶

scoop bucket add verda https://github.com/verda-cloud/homebrew-tap
scoop install verda-cli

Linux packages (deb / rpm / apk)¶

Download .deb, .rpm, or .apk packages from GitHub Releases:

# Debian / Ubuntu
sudo dpkg -i verda_VERSION_linux_amd64.deb

# RHEL / Fedora
sudo rpm -i verda_VERSION_linux_amd64.rpm

# Alpine
sudo apk add --allow-untrusted verda_VERSION_linux_amd64.apk

Manual download¶

Download the binary for your platform from GitHub Releases:

tar xzf verda_*.tar.gz
sudo mv verda /usr/local/bin/

Go install¶

go install github.com/verda-cloud/verda-cli/cmd/verda@latest

Verify & update¶

verda version            # verify installation
verda update             # update to latest
verda update --version v1.0.0  # specific version

Quick start¶

1. Configure credentials

verda auth login

2. Explore available resources

verda locations                        # datacenter locations
verda instance-types --gpu             # GPU instance types with pricing
verda availability --location FIN-01   # what's in stock

3. Deploy a VM

# Interactive wizard
verda vm create

# Non-interactive
verda vm create \
  --kind gpu \
  --instance-type 1V100.6V \
  --location FIN-01 \
  --os ubuntu-24.04-cuda-13.0-open-docker \
  --os-volume-size 100 \
  --hostname gpu-runner

4. Connect

verda ssh gpu-runner

Features¶

• Interactive and non-interactive modes — guided wizards for quick tasks, flags for scripts and CI/CD
• Multiple output formats — table (human-readable), JSON, and YAML
• Multi-profile authentication — switch between accounts and environments
• Cost visibility — estimate costs before provisioning, track burn rate in real time
• AI agent integration — MCP server and skills for Claude Code, Cursor, and other AI tools
• Built-in diagnostics — verda doctor checks credentials, connectivity, and configuration

What you can manage with the CLI¶

• Compute
  • GPU and CPU instances (create, list, describe, start, shutdown, hibernate, delete)
  • SSH directly into running instances
• Storage
  • Block volumes (create, resize, clone, detach, delete)
  • Trash management with 96-hour recovery window
• Resources
  • SSH keys for instance access
  • Startup scripts for automated provisioning
  • Reusable templates for instance configurations
• Billing
  • Cost estimation before provisioning
  • Running cost and burn rate tracking
  • Account balance and runway forecasting

Docs¶