All Products
Search
Document Center

Elastic Compute Service:Import a custom image

Last Updated:Apr 27, 2026

Import an on-premises image to create ECS instances or replace the system disk OS of existing instances.

Import a Linux image

image
  1. Review the Alibaba Cloud image requirements (Linux).

  2. Prepare an on-premises image file.

    1. Create a virtual machine and install an operating system in VirtualBox.

    2. Install required plug-ins.

    3. Check and fix the image with the image compliance tool.

    4. Obtain the Linux image file.

    5. Convert the image format: ECS supports RAW, VHD, QCOW2, and VMDK formats only. Convert your image if it uses a different format.

  3. Import the custom image: Upload the image file to OSS and import it to ECS.

  4. Use a custom image to create one or more instances.

Import a Windows image

image
  1. Review the Windows image requirements.

  2. Prepare an on-premises image file.

    1. Create a virtual machine and install an operating system in VirtualBox.

    2. Install required plug-ins.

    3. Obtain the Windows image file.

    4. Convert the image format: ECS supports RAW, VHD, QCOW2, and VMDK formats only. Convert your image if it uses a different format.

  3. Import the custom image: Upload the image file to OSS and import it to ECS.

  4. Use a custom image to create one or more instances.