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¶

Start an offline instance:

verda vm action start <instance-id>

Shutdown an instance gracefully:

verda vm action shutdown <instance-id>

Force shutdown (immediate, may cause data loss):

verda vm action force-shutdown <instance-id>

Hibernate an instance (saves state, stops billing, can resume later):

verda vm action hibernate <instance-id>

Delete an instance:

verda vm action delete <instance-id>

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 gpu-a100-80gb

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