Help Center/ Image Management Service/ User Guide/ Creating a Private Image from an Image File/ Creating a Linux System Disk Image from an ISO File/ Registering a Linux ISO File as a Private Image
Updated on 2025-08-26 GMT+08:00
View PDF
Share

Registering a Linux ISO File as a Private Image

Scenarios

Register an external ISO file on the cloud platform as a private image (ISO image). Before registering an image, upload the ISO file to the OBS bucket.

An ISO image cannot be replicated or exported.

Prerequisites

  • The file to be registered must be in ISO format.
  • The ISO image file has been uploaded to the OBS bucket. For details, see Upload an Image File.

    The ISO image file name can contain only letters, digits, hyphens (-), and underscores (_). If the image file name does not meet the requirements, change the name before uploading the image file to the OBS bucket.

Procedure

  1. Access the IMS console.

    1. Log in to the management console.
    2. Under Compute, click Image Management Service.

      The IMS console is displayed.

  2. Register an ISO file as an ISO image.

    1. Click Create Image in the upper right corner.
    2. In the Image Type and Source area, select Import Image for Type and then select ISO image for Image Type.
    3. In the image file list, select the bucket and then the image file.
      Figure 1 Creating a private image from an ISO file
    4. In the Image Information area, set the following parameters.
      Figure 2 Configuring image information

      • Architecture: Select x86 or ARM.

        This parameter is required only in regions that support both x86 and Arm.

      • Boot Mode: Select BIOS or UEFI. Ensure that the selected boot mode is the same as that in the image file, or the ECSs created from this image will not be able to boot up. The Arm architecture does not support the BIOS boot mode.
      • OS: Select the OS specified in the ISO file to ensure that the image can be created and used properly.
      • License Type: If you have already had an OS license, you can bring your own license (BYOL) and you do not need to apply for a new license anymore. This parameter is only available for Windows.
      • System Disk: Set the system disk capacity (value range: 40 GB to 1024 GB), which must be no less than the capacity of the system disk in the image file.
      • Name: Enter a name for the image to be created.
      • Enterprise Project: Select the enterprise project your image belongs to.
      • Tag: (Optional) Add a tag to the image to be created.

        If your organization has configured tag policies for images, you need to add tags to your images based on the policies. If you add a tag that does not comply with the tag policies, images may fail to be created. Contact the organization administrator to learn more about the tag policies.

        • Each tag consists of a key and a value. The key contains a maximum of 36 characters, and the value contains a maximum of 43 characters. The key cannot be left blank or an empty string. The value cannot be left blank but can be an empty string.
        • An image can have a maximum of 10 tags.
      • (Optional) Description: Describe the image as needed.
    5. Click Next.
    6. Confirm the settings. Read and agree to the disclaimer and click Submit.

  3. Switch back to the Image Management Service page to check the image status.

    When the image status changes to Normal, the image is registered successfully.