Oracle Cloud Infrastructure Documentation

Importing Custom Images

Oracle Cloud Infrastructure enables you to import a custom image and then use the custom image to launch virtual machine (VM) instances in emulation or paravirtualized mode. For more information about supported images and image requirements, see Bring Your Own Custom Image for Emulation Mode Virtual Machines and Bring Your Own Custom Image for Paravirtualized Mode Virtual Machines. This topic walks through the custom image import process. You need to prepare the image prior to importing, for importing Linux-based images in paravirtualized or emulated mode see Preparing a Custom Linux Image for Import. For importing Windows-based images, see Preparing a Custom Windows Image for Emulation Mode. Windows-based images only support importing in emulated mode.

Importing Custom Linux-Based Images

Tip

If your custom image supports paravirtualized drivers, we recommend you use paravirtualized mode.

You can import Linux-based images using paravirtualized mode or emulated mode.

If your Linux kernel version is 3.4 or newer, your Linux system supports paravirtualized drivers. See To verify the kernel version using the uname command in Bring Your Own Custom Image for Paravirtualized Mode Virtual Machines for more information.

For older versions of Linux-based operating systems, use emulated mode, see Bring Your Own Custom Image for Emulation Mode Virtual Machines.

Prerequisites

Prior to importing a custom image, you need to:

To import a custom Linux-based image using the Console

Once you click Import Image, you'll see the imported image in the Custom Images list for the compartment, with a status of IMPORTING. Once the import completes successfully, the status will change to AVAILABLE. If the status does not change, or no entry appears in the Custom Images list, the import failed. If the import failed, make sure you have read access to the Object Storage object, and that the object contains a supported image.

Next Steps

After importing the custom Linux-based image, the next steps are:

  1. Launch an instance based on the custom image. See Creating an Instance for more information. To select a custom image, choose CUSTOM IMAGE as the Image Source. You can then select the imported custom image from the Images list.

  2. Create a serial console connection to the instance. See Instance Console Connections for more information.

See Compute for current issues and workarounds for imported custom images.

Importing Custom Windows-Based Images

You can import Windows-based images using emulated mode only, see Bring Your Own Custom Image for Emulation Mode Virtual Machines.

Prerequisites

Prior to importing a custom Windows-based image, you need to:

To import a custom Windows-based image using the Console

The Image Details page will be displayed with the image lifecycle state as IMPORTING. Once the import has completed successfully, the lifecycle state will change to AVAILABLE.

If the status does not change, or no entry appears in the Custom Images list, the import failed. If the import failed, make sure you have read access to the Object Storage object, and that the object contains a supported image.

Next Steps

After importing the custom Windows-based image, the next steps are:

  1. Launch an instance based on the custom image. See Creating an Instance for more information. To select a custom image, choose CUSTOM IMAGE as the Image Source. You can then select the imported custom image from the Images list. You also need to enable RDP access for the instance, see To enable RDP access for more information.

  2. Configure the instance to use the Oracle-provided Key Management Service (KMS) server for activation.

    To configure the instance to use the Oracle-provided KMS server