Skip to main content

Manage your VMs

Creating a new VM

Use the compute vms create command to create a VM of your choice. As an example, you can create a VM that uses a single Nvidia A40 GPU:

crusoe compute vms create \
--name my-vm \
--type a40.1x \
--location us-northcentral1-a \
--image ubuntu22.04:latest \
--keyfile ~/.ssh/id_ed25519.pub

You can find possible values for type and location by running crusoe compute vms types and crusoe locations list respectively.

If you don't specify an image, the VM will defailt to the latest version of ubuntu 22.04. Run crusoe compute images list for more options.

Viewing all existing VMs

Use the compute vms list command to list all existing VMs.

crusoe compute vms list

Update an existing VM

Currently, you can start or stop an existing VM. You can also update properties like VM type, IP address type, and Infiniband partition.

A stopped VM retains all data stored on that VM. An on-demand stopped VM is not billed, but a VM currently in an instance commitment is billed regardless of its state. Learn more about VM billing.

Use the compute vms <stop|start|reset> command to change the state of an already existing VM.

Use the compute vms update <name> command to make updates to the Infiniband partition, VM type, or public IP type via the --ib-partition-id, --type, or --public-ip-type flags, respectively.

Updating state from within the VM

You can use standard unix commands like shutdown and reboot to change the state of a running VM. If you run shutdown, the VM will shut down and transition to the Stopped state. If you run reboot, the VM will reboot and will remain unreachable until it has fully restarted; however, the state will still be shown as Running throughout the restart.

Deleting a VM

info

Warning: deleting a VM will also delete all data stored on the VM. Do not delete a VM unless you also wish to delete any downloaded or derived data.

Use the compute vms delete command to delete a VM of your choice. As an example, you can delete a VM by replacing VM_NAME with the name of the VM you wish to delete:

crusoe compute vms delete --name VM_NAME

If you are having issues creating or deleting VMs, please contact support.