Skip to main content
Download and create an image
Last update:

Download and create an image

You can download images to the Selectel image repository:

You can create your own image from the disk.

Limitations⁠

When uploading an image to the Selectel Image Store from a file and link, the image size must be less than 2048 GB (2 TB).

If you need to load an image from a larger file, load it via object storage.

You can create an image from a disk size less than 2048 GB (2 TB).

Load an image from a file⁠

You can download an image to the Selectel image repository from a file on your local computer. Check the size limits for the image to be downloaded.

  1. In the Control panel, on the top menu, click Products and select Cloud Servers.

  2. Go to the Images section.

  3. Click Create Image.

  4. Enter a name for the image.

  5. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  6. Select the operating system.

  7. Select a file as the image source.

  8. Click Download.

  9. Select an image format or container format. For more information about formats, see Own Images.

    If you are downloading an archive with the .ova container format, we recommend unzipping the archive before downloading for the image to work correctly.

    If you don't know what formats to specify, specify raw image format, bare container format.

  10. Optional:Check the Specify minimum disk and memory size checkbox and specify the RAM size in MB and disk size in GB. This is the minimum disk and RAM size with which you can create a server from this image. You cannot specify minimum values for images in iso format.

    Once the image is created, you cannot change the minimum disk and memory size in the control panel.

  11. Click Create.

You can upload an image to the Selectel image repository via a public link to the image file. Check the size limits for the image to be uploaded.

  1. In the Control panel, on the top menu, click Products and select Cloud Servers.

  2. Go to the Images section.

  3. Click Create Image.

  4. Enter a name for the image.

  5. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  6. Select the operating system.

  7. Select the URL as the source of the image.

  8. Enter a link to the image file in the format https://example.com/file.raw.

  9. Select an image format or container format. For more information about formats, see Own Images.

    If you are downloading an archive with the .ova container format, we recommend unzipping the archive before downloading for the image to work correctly.

    If you don't know what formats to specify, specify raw image format, bare container format.

  10. Optional:Check the Specify minimum disk and memory size checkbox and specify the RAM size in MB and disk size in GB. This is the minimum disk and RAM size with which you can create a server from this image. You cannot specify minimum values for images in iso format.

    Once the image is created, you cannot change the minimum disk and memory size in the Control Panel.

  11. Click Create.

Load image via object storage⁠

  1. Upload the image to the object store via segmented download.

  2. Obtain an IAM token for the project (X-Auth-Token).

  3. In the query output, copy the value in the X-Subject-Token field.

  4. Open the CLI on the local computer.

  5. Create an image through the API:

    curl 'https://<pool>.cloud.api.selcloud.ru/image/v2/images' \
      -H 'X-Auth-Token: <x_auth_token>' \
      -H 'Content-Type: application/json;charset=utf-8' \
      --data '{"name":"<image_name>","disk_format":"<image_format>","container_format":"<container_format>"}'

    Specify:

    • <pool> — pool to which the image will be loaded, for example ru-1. Address (URL) depends on the region and pool, you can look in the URL list. The list of available pools can be viewed in the table Selectel Infrastructure;

    • <x_auth_token> — The IAM token for the project you copied in step 3;

    • <image_name> — image name;

    • <image_format> — image format. Read more about image formats in the subsection Own images. If you don't know what format to specify, specify raw;

    • <container_format> — container format. Read more about container formats in the subsection Own images.

      If you are downloading an archive with the .ova container format, we recommend unzipping the archive before downloading for the image to work correctly.

      If you don't know which format to specify, specify bare.

  6. In the query output, copy the value in the id field.

  7. Get a reference to the image in the object store.

  8. Upload the image to the image repository:

    curl 'https://<pool>.cloud.api.selcloud.ru/image/v2/images/<image_id>/import' \
      -X POST \
      -H 'Content-Type: application/octet-stream' \
      -H 'X-Image-Meta-Store: <pool_segment>' \
      -H 'X-Auth-Token: <x_auth_token>' \
      --data-raw '{"method":{"name":"web-download","uri":"<object_storage_url>"}}'

    Specify:

    • <pool> — pool to which the image will be loaded, for example ru-1. Address (URL) depends on the region and pool, you can look in the URL list. The list of available pools can be viewed in the table Selectel Infrastructure;
    • <image_id> — The ID of the image you copied in step 6;
    • <pool_segment> — pool segment into which the image will be loaded, e.g. ru-1a. The list of available pool segments can be viewed in the table below. Selectel Infrastructure;
    • <x_auth_token> — The IAM token you copied in step 3;
    • <object_storage_url> — reference to the image in the object storage of the form https://<uuid>.selstorage.ru/container_name/object_name which you received at step 7.

Download the vmdk from a file or from a link⁠

Look for restrictions on the size of the downloaded image.

  1. Export a virtual machine from VMware in .ovf format. For more information, see the Export an ovf Template instructions in the VMware documentation.

    If the virtual disk type is MONOLITHIC_SPARSE or MONOLITHIC_FLAT, you can skip this step, but we recommend exporting the VM in .ovf format.

  2. In the Control panel, on the top menu, click Products and select Cloud Servers.

  3. Go to the Images section.

  4. Click Create Image.

  5. Enter a name for the image.

  6. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  7. Select the operating system.

  8. Select a file or URL as the image source.

  9. If you have selected a file, click Upload.

  10. If you selected URL, enter a link to the image file in https://example.com/file.raw format.

  11. Select the format of the image:

    • vmdk — if the virtual machine was exported from VMware in the format .ovf or you are booting a virtual disk with a type of MONOLITHIC_SPARSE;
    • raw — if you boot a virtual disk with the type MONOLITHIC_FLAT.

  12. Select a container format:

    • ovf — if the virtual machine was exported from VMware in the format .ovf;
    • bare metal — if you boot a virtual disk with the type MONOLITHIC_SPARSE or MONOLITHIC_FLAT.

  13. Optional:Check the Specify minimum disk and memory size checkbox and specify the RAM size in MB and disk size in GB. This is the minimum disk and RAM size with which you can create a server from this image. You cannot specify minimum values for images in iso format.

    Once the image is created, you cannot change the minimum disk and memory size in the Control Panel.

  14. Click Create.

Create an image from a disk⁠

An image is a complete copy of a disk. An image can be created from any local or network disk on the cloud server. The disk can be either bootable or optional. Look for restrictions on the size of the disk from which you can create an image.

You can use the image:

  • to quickly configure identical cloud servers — server cloning. If the server has the operating system and software installed, you can deploy already configured servers from the boot disk image. This is faster than setting up the desired configuration of multiple servers;
  • to change the type of boot disk;
  • transferring the server to other pools, projects or accounts;
  • cloud server disk export;
  • If the image from which the server was previously created is deleted, you can create an image from the server disk and, if necessary, create the same cloud server.

  1. If the disk is connected to a cloud server, we recommend shutting down the cloud server — a non-consistent image may be created from a running disk.

  2. In the dashboard, on the top menu, click Products and select Cloud Servers.

  3. Go to the Images section.

  4. Click Create Image.

  5. Enter a name for the image.

  6. Select the pool segment to which the image will be loaded.

    Images smaller than 16 GB are automatically replicated to neighboring segments in the pool.

  7. Select the operating system.

  8. Select the disk as the image source.

  9. Select the disk from which the image will be created. You can only create an image in the pool segment where the disk is located.

  10. Optional:Check the Specify minimum disk and memory size checkbox and specify the RAM size in MB and disk size in GB. This is the minimum disk and RAM size with which you can create a server from this image. You cannot specify minimum values for images in iso format.

    Once the image is created, you cannot change the minimum disk and memory size in the Control Panel.

  11. Click Create.