Instances¶

Use the Verda CLI to create, manage, and connect to GPU and CPU instances. The CLI supports both an interactive wizard and flag-based commands for automation.

Create an instance¶

Interactive mode

Launch the creation wizard:

verda vm create

The wizard guides you through selecting a location, instance type, OS image, SSH keys, and volumes.

Non-interactive mode

Specify all options as flags:

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

To wait until the instance is ready before returning:

verda vm create --hostname "training-01" --wait

Create from a template

If you have a saved template, create an instance from it:

verda vm create --from my-template

See Templates for how to create and manage templates.

List instances¶

View all your instances:

verda vm list

For JSON output (useful for scripting):

verda vm list -o json

Describe an instance¶

Get detailed information about a specific instance:

verda vm describe <instance-id>

Check availability¶

See which instance types are available in a specific location:

verda availability --location FIN-01

Filter by spot instances:

verda availability --spot

Instance actions¶

Info

Hibernate is deprecated and will be removed soon, since it has the same effect as delete. Please use delete instead.

The common actions have shortcut commands that take the instance ID (or hostname):

verda vm start <instance-id>       # start an offline instance
verda vm shutdown <instance-id>    # graceful shutdown
verda vm delete <instance-id>      # delete (alias: verda vm rm)

For force shutdown — and as a flag-driven alternative to the shortcuts — use verda vm action with --id and --action:

verda vm action --id <instance-id> --action force_shutdown
verda vm action --id <instance-id> --action shutdown

--action accepts start, shutdown, force_shutdown, and delete. Run verda vm action with no flags on a terminal to pick a VM and action interactively.

Warning

Deleting an instance is permanent. The CLI asks for confirmation before proceeding (pass --yes to skip it in scripts).

SSH into an instance¶

Connect to a running instance over SSH:

verda ssh <instance-id-or-hostname>

Specify a user or key:

verda ssh <instance-id> --user ubuntu --key ~/.ssh/my-key

Port forwarding is supported by passing arguments after --:

verda ssh <instance-id> -- -L 8888:localhost:8888

Browse instance types¶

List all available instance types with specs and pricing:

verda instance-types

Filter by GPU or CPU:

verda instance-types --gpu
verda instance-types --cpu

Show spot pricing:

verda instance-types --spot

Browse OS images¶

List available operating system images:

verda images

Filter by compatibility with a specific instance type:

verda images --type 1V100.6V

List locations¶

See all available datacenter locations:

verda locations

Command aliases¶

The vm command also accepts instance and instances as aliases:

verda instance list      # same as verda vm list
verda instances list     # same as verda vm list