Create a VM

info

Crusoe Cloud is currently in private beta. If you do not currently have access, please request access to continue.

Creating and accessing VMs is fundamental to Crusoe Cloud. You can create VMs via the CLI or UI:

CLI

Use the vm 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 vm create \
  --name my-vm \
  --type a40.1x \
  --keyfile ~/.ssh/id_ed25519.pub

name, type, and keyfile are required arguments. You can find the available machine types via the vm types command.

UI

In order to create a VM via the Crusoe Cloud console:

• Visit the Crusoe Cloud console
• Click the "Instances" tab in the left nav
• Click the "New Instance" button
• Select the desired instance type (e.g. "1x NVIDIA A40")
• Input a name for the VM, using only letters, numbers, - and _
• Select the desired SSH key (e.g. "Default"); otherwise, upload an SSH public key (e.g. ~/.ssh/id_ed25519.pub)
• Click the "Create Instance" button

info

Crusoe Cloud supports all SSH public key formats that are accepted by OpenSSH. These include:

• [email protected]
• ecdsa-sha2-nistp256
• ecdsa-sha2-nistp384
• ecdsa-sha2-nistp521
• [email protected]
• ssh-ed25519
• ssh-dss
• ssh-rsa

For more information on the authorized key format please see the OpenSSH docs.

Access the VM via SSH

If VM creation succeeds, the VM will start and you will be provided with an IP address for you to SSH into:

ssh root@<ip>

info

Note: It may take up to a minute for the VM to start, and you may get Connection Refused errors until the VM starts. If you get an error immediately after creating or starting a VM, wait a minute or two and try again.

If VM creation fails or you are otherwise unable to access a running VM, ensure that you have billing enabled and that you have installed and configured the CLI properly. If you have successfully completed these steps, please contact support.