---
description: >-
  Manage Verda infrastructure from the command line. The Verda CLI lets you
  provision instances, manage storage, and monitor costs without leaving your
  terminal.
revision_date: 2026-07-23
---

# 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.

![Verda CLI in action](https://docs.verda.com/assets/cli-overview-demo.gif)

***

#### Install

=== "Quick install (macOS / Linux)"

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

    Install to a custom directory:

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

=== "Homebrew (macOS / Linux)"

    ```bash
    brew install verda-cloud/tap/verda-cli
    ```

=== "Scoop (Windows)"

    ```powershell
    scoop install git
    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](https://github.com/verda-cloud/verda-cli/releases):

    ```bash
    # 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](https://github.com/verda-cloud/verda-cli/releases):

    | Platform | File |
    |----------|------|
    | macOS (Apple Silicon) | `verda_VERSION_darwin_arm64.tar.gz` |
    | macOS (Intel) | `verda_VERSION_darwin_amd64.tar.gz` |
    | Linux (x86_64) | `verda_VERSION_linux_amd64.tar.gz` |
    | Linux (ARM64) | `verda_VERSION_linux_arm64.tar.gz` |
    | Windows (x86_64) | `verda_VERSION_windows_amd64.zip` |
    | Windows (ARM64) | `verda_VERSION_windows_arm64.zip` |

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

=== "Go install"

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

After installing, verify and update:

```bash
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](https://docs.verda.com/welcome-to-verda/api-credentials/#create-cloud-api-credentials).

```bash
verda auth login
```

After finishing the wizard, verda-cli tool will save your credentials to `~/.verda/credentials`. Check [this documentation](https://docs.verda.com/cli/getting-started/#credential-resolution) for how the CLI decides where to look for the credentials.

**2. Explore available resources**

```bash
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**

```bash
# 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**

```bash
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
    * 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](https://docs.verda.com/cli/getting-started/)

[Instances](https://docs.verda.com/cli/instances/)

[Templates](https://docs.verda.com/cli/templates/)

[Storage](https://docs.verda.com/cli/storage/)

[Object Storage](https://docs.verda.com/cli/object-storage/)

[Container Registry](https://docs.verda.com/cli/container-registry/)

[SSH Keys & Startup Scripts](https://docs.verda.com/cli/resources/)

[Cost & Status](https://docs.verda.com/cli/cost-and-status/)

[Skills](https://docs.verda.com/cli/skills/)

[MCP Server](https://docs.verda.com/cli/mcp/)