Skip to main content

Images

Crusoe Cloud provides two types of VM images: Curated images, which are created and maintained by the Crusoe Cloud team, and Custom images, which are customized by the developer for use within their organization's project based on the curated image.

Curated Images

Curated images are images provided by Crusoe Cloud and made available to all developers on the platform. These images contain a base operating system, e.g. Ubuntu, and additional software where specified, to provide a "batteries included" experience.

List of Curated Images

Here is a list of current images

Image NameDescription
ubuntu20.04Ubuntu 20.04 base image.
ubuntu22.04Ubuntu 22.04 base image.
ubuntu20.04-nvidia-sxm-dockerUbuntu 20.04 with NVIDIA drivers supporting SXM type GPUs, InfiniBand support, and a docker runtime.
ubuntu20.04-nvidia-pcie-dockerUbuntu 20.04 with NVIDIA drivers supporting PCIe type GPUs and a docker runtime.
ubuntu22.04-nvidia-sxm-dockerUbuntu 22.04 with NVIDIA drivers supporting SXM type GPUs, InfiniBand support, and a docker runtime.
ubuntu22.04-nvidia-pcie-dockerUbuntu 22.04 with NVIDIA drivers supporting PCIe type GPUs and a docker runtime.
ubuntu22.04-nvidia-slurmUbuntu 22.04 with NVIDIA drivers and Slurm support.
ubuntu-rocmUbuntu with AMD ROCm drivers supporting OAM type GPUs.

Each image also has a tag which is commonly latest for the latest version or a yyyy-mm-dd type string for the date the image was created.

Default user

The default user for all ubuntu based images is ubuntu. root access is considered to be deprecated, and you will be warned on login.

Custom Images

Custom images are customer-managed, modified versions of curated images. Once customers have created a virtual machine (VM) from a base image and customized it with preferred configurations and software, they can stop the VM and create a custom image from its boot disk.

When creating subsequent VMs within their project, customers can select their newly created custom image as the base image. Unlike curated images, custom images are region and project specific and cannot be shared outside the project or the specific region it was created in.

Custom images can only be created from the boot disks of a VM. Like curated images, custom images support tags with the default tag being latest.

Custom Image maintenance

Customers are solely responsible for the maintenance of their custom images. Crusoe does not update, manage or modify those images in any way. Deleting the source VM used to create the custom image is allowed and will not affect the custom Image itself.

Please remove any local disk mount entries from the /etc/fstab file on the VM before creating a custom image in order to prevent boot failures for subsequent VMs.

info

Note: While customers can upgrade the kernel version on their custom images, it can lead to issues with driver and other software compatibility on Crusoe Cloud. Please contact support before performing major kernel version upgrades.

Quotas

By default, customers can create up to 128 custom images per project. To request an increase in this quota, please contact support

Limitations

Customers cannot do the following:

  1. Create a custom image from a VM while it is not SHUTOFF.
  2. Start a VM while a custom image is being created from it.
  3. Create a custom image from a disk which is not an OS disk.
  4. Delete all tags for a custom image. Every custom image must have at least one tag.

Billing

Custom images are billed based on the amount of data used in the persistent disk. Refer persistent disk pricing here