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¶

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

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

brew install verda-cloud/tap/verda-cli

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

# 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

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

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

After installing, verify and update:

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

Quick start¶

1. Configure credentials

What you need to authenticate:

• Verda API client ID
• Verda API client secret

You can create them by following this documentation.

verda auth login

After finishing the wizard, verda-cli tool will save your credentials to ~/.verda/credentials. Check this documentation for how the CLI decides where to look for the credentials.

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, delete)
  • SSH directly into running instances
• Storage
  • Block volumes (create, resize, clone, detach, delete)
  • Trash management with 96-hour recovery window
  • S3-compatible object storage (buckets, objects, sync, resumable transfers, presigned URLs)
  • Container Registry (push, copy, browse, and delete images on vccr.io)
• 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¶

Getting Started

Instances

Templates

Storage

Object Storage

Container Registry

SSH Keys & Startup Scripts

Cost & Status

Skills

MCP Server