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 Name | Description | Lifecycle Stage |
|---|---|---|
ubuntu22.04 | Ubuntu 22.04 base image. | GA |
ubuntu22.04-nvidia-sxm-docker | Ubuntu 22.04 with NVIDIA drivers supporting SXM type GPUs, InfiniBand support, and a docker runtime. | GA |
ubuntu22.04-nvidia-pcie-docker | Ubuntu 22.04 with NVIDIA drivers supporting PCIe type GPUs and a docker runtime. | GA |
ubuntu22.04-nvidia-slurm | Ubuntu 22.04 with NVIDIA drivers and Slurm support. | GA |
ubuntu-rocm | Ubuntu 22.04 with AMD ROCm drivers supporting OAM type GPUs. | GA |
ubuntu20.04 | Ubuntu 20.04 base image. | EOL (May 2025) |
ubuntu20.04-nvidia-sxm-docker | Ubuntu 20.04 with NVIDIA drivers supporting SXM type GPUs, InfiniBand support, and a docker runtime. | EOL (May 2025) |
ubuntu20.04-nvidia-pcie-docker | Ubuntu 20.04 with NVIDIA drivers supporting PCIe type GPUs and a docker runtime. | EOL (May 2025) |
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 (Beta)
Custom Images are currently in beta and may not be available for immediate provisioning. If you require access, please contact our sales team to discuss your use case.
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.
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:
- Create a custom image from a VM while it is not SHUTOFF.
- Start a VM while a custom image is being created from it.
- Create a custom image from a disk which is not an OS disk.
- 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