Skip to main content
Updated May 8, 2026 The raff vm command group covers every Virtual Machine operation in the public API. Each subcommand also supports --output json for scripting.

Subcommand index


list

List every VM in the current project. Output columns: ID, NAME, STATUS, IP ADDRESS, CPU, RAM, STORAGE, REGION, CREATED.

get

Show full details for one VM — pricing, tags, networks, attached volumes, snapshots, backups.

create

Create a new VM. Required: --name, --template-id, --pricing-id, --region. Get template IDs via List Templates and pricing IDs via List VM Pricing or the Pricing page.

update

Update VM metadata. Currently rename-only.

delete

Delete the VM. By default, attached volumes detach (preserved) and VPCs are kept — pass --volume-action delete to also remove volumes and --delete-vpc to remove VPCs (shared VPCs are auto-preserved if other VMs still use them). Pass --force to skip the confirmation prompt — required in scripts. The dashboard exposes the same options as a two-step confirmation dialog; see Delete a VM for the full rules.

bulk-delete

Delete multiple VMs in one call. Required: --ids. By default, attached volumes detach (preserved) and VPCs are kept; pass --volume-action delete to also remove volumes, and --delete-vpc to remove VPCs no longer in use. Shared VPCs are auto-preserved if other VMs still use them — see Delete a VM.

Power commands

Use hard-reboot only when graceful reboot is hung. The API behavior matches the dashboard — see Manage power.

reinstall

Reinstall the VM’s OS with a different template. Erases the OS disk; preserves attached volumes, IP, VPC, tags, and specs. See Reinstall.

factory-reset

Reset to the original template the VM was created with. Same preservation rules as reinstall.

rename

reset-password

Resets the root (Linux) or Administrator (Windows) password to a new generated value. Output shows the new password — copy it immediately. The VM reboots if active to apply the change.

resize

Change the compute plan (vCPU / RAM / base disk). Triggers a reboot. Pricing pro-rates against the current term.

resize-disk

Grow the OS disk. Cannot shrink. Filesystem expansion inside the guest is not automatic — see Resize for the growpart / resize2fs steps.

save-image

Snapshot the OS disk as a reusable Custom Image you can launch other VMs from. See Custom Images.

ip attach

Attach a reserved public IP to the VM.

ip detach

Detach a public IP. Reserved IPs return to your account; auto-assigned IPs return to the regional pool.

sg add

Attach a Firewall Group to the VM’s public IP. A reboot is required for the new rules to take effect inside the guest — see Update rules.

sg remove

Detach a Firewall Group. Reboot required.

vpc attach

Add a VPC interface to the VM. The VM gets a private IP from the VPC’s CIDR.

vpc detach

Remove the VPC interface. Blocked if it would leave the VM with zero interfaces — attach another network first.

tags add

tags remove

tags set

Replace the VM’s tag set with the given list (clears any existing tags first).

tags list

notes set

Replace the VM’s note. See VM notes.

notes append

Append to the existing note (newline-separated).

notes get

networks

List every network attached to the VM — public IPs, VPCs, with their addresses and statuses.

Project commands

Manage projects.

VPC commands

Private networks.

API Reference

The HTTP API behind the CLI.
Last modified on May 11, 2026