Creating custom boot disk images

Custom images allow you to quickly create virtual machines (VMs) or boot disks with all the necessary software, OS and configuration, which can greatly reduce infrastructure deployment time and ensure consistency across environments. You can create and edit or delete custom boot disk images in the web console or by using the CLI. Alternatively, you can create custom boot disk images by using Packer with the Nebius plug-in.

Before you start

Make sure that you have enough quotas for images (Number of images and Total storage capacity of all images). You can view quotas and request changes on the Administration → Limits → Quotas page of the web console.
Prepare a dedicated VM with the required custom software. Create a VM, connect to it and install the software that the image should inherit. The image will be based on the boot disk of this VM and will include the installed software.

How to create a custom boot disk image

To create an image from an existing boot disk:

Web console
CLI

In the web console, go to Storage → Disks.
Click Create resource and then select Image.
In the window that opens, specify the required parameters:
- Name: Name of your image.
- Project of source disk: Project that the source disk of your image belongs to.
- Source disk: Disk used as the source for your image. The image will retain the basic architecture, size and installed software of the source disk.
  You cannot create images from disks that are attached to currently running VMs. Stop the VM before attempting to create an image.
(Optional) Specify the image family. It represents a new or existing label used to group your custom images into a family. If you create a VM or a boot disk from this image family, you will use the latest image in the family.
(Optional) Specify the image description.
(Optional) Under Advanced settings, specify:
- Image family description: Description of the family that your new image belongs to (if you specified one).
- Recommended platforms: Comma-separated list of compatible platforms that your image will use by default.
- Unsupported platforms: Comma-separated list of platforms that your image architecture is not compatible with. Must be in the <platform>=<description> format. For example, gpu-l40s-d=not supported.
Click Create image.

The new image will appear in the Images tab in

Storage → Disks.

If the source disk for your image is attached to a currently running VM, stop it:
```
nebius compute instance stop --id <VM_ID>
```
To get the VM ID, run nebius compute instance list.
Create an image from a boot disk:
```
nebius compute image create \
   --name <image_name> \
   --parent-id <project_ID> \
   --source-disk-id computedisk-e*** \
   --image-family <image_family_name> \
   --description <image_description> \
   --image-family-human-readable <image_family_description> \
   --recommended-platforms "<platform_1>,<platform_2>,..." \
   --unsupported-platforms "<platform>=<description>"
```
The command contains the following parameters:
- --name: Name of your image.
- --parent-id: ID of the project that the source disk belongs to.
- --source-disk-id: ID of the source disk that you want to create an image from. To get both --parent-id and --source-disk-id, run nebius compute disk list.
- --image-family (optional): New or existing label used to group your custom images into a family. If you create a VM or a boot disk from this image family, you will use the latest image in the family.
- --description (optional): Description of your image.
- --image-family-human-readable (optional): Description of the family that your new image belongs to (if you specified one).
- --recommended-platforms (optional): Comma-separated list of compatible platforms that your image will use by default.
- --unsupported-platforms (optional): Comma-separated list of platforms that your image architecture is not compatible with. Must be in the <platform>=<description> format. For example, gpu-l40s-d=not supported.

How to edit or delete a custom boot disk image

Web console
CLI

In the web console, go to Storage → Disks.
Switch to the Images tab and open the image you want to access. The Image overview tab shows detailed information about the image and the source disk that it’s based on.
On the image page, switch to the Settings tab.
Update the image name or click Delete image to delete it.

To check the status of your image, run:
```
nebius compute image get computeimage-e***
```
To get the image ID, run nebius compute image list.
To edit your image (for example, rename it), run:
```
nebius compute image update computeimage-e***
```
For more information about the command parameters, see the command reference.

To delete your image, run:

nebius compute image delete computeimage-e***

How to create a VM from a custom image

After your custom boot disk image is ready, you can deploy a VM from it or create a boot disk based on this image.

Web console
CLI

To create a VM from a custom image:

In the web console, go to Storage → Disks → Images.
Next to the image, click → Create virtual machine.
Configure and create the VM.

You can also select a custom image on the VM creation page. To do that, click

in the Boot disk section and select your custom image or image family in Image configuration.

Create a boot disk based on a custom image:

nebius compute disk create \
   --name <disk_name> \
   --type network_<ssd|ssd_non_replicated|ssd_io_m3> \
   --size-gibibytes <size> \
   --block-size-bytes <block_size> \
   --source-image-id computeimage-***

To get the image ID, run nebius compute image list.

Create a VM with the new disk. Use the ID of the boot disk created earlier with the --boot-disk-existing-disk-id parameter.

Virtual machines

Slurm and Soperator in Nebius AI Cloud

Managed Service for Kubernetes®

Creating custom boot disk images

Before you start

How to create a custom boot disk image

How to edit or delete a custom boot disk image

How to create a VM from a custom image

Virtual machines

Slurm and Soperator in Nebius AI Cloud

Managed Service for Kubernetes®

​Before you start

​How to create a custom boot disk image

​How to edit or delete a custom boot disk image

​How to create a VM from a custom image

Before you start

How to create a custom boot disk image

How to edit or delete a custom boot disk image

How to create a VM from a custom image