Skip to main content

Overview

The Images panel under Project → Compute → Images provides access to all images and snapshots available in your project. This includes public images shared by your administrator, private images you upload, and snapshots you capture from running instances.
Prerequisites
  • member role for viewing and launching from images
  • Images must be in Active status to be launchable
  • For uploading images: file size limit is enforced by your administrator (typically 100 GB per image)

Image List

ColumnDescription
NameImage display name (click to open detail view)
TypeImage (uploaded) or Snapshot (from instance)
StatusActive, Queued, Saving, Deactivated, Deleted
VisibilityPublic (all projects), Private (current project only), Shared
ProtectedProtected images cannot be deleted without removing protection first
Disk Formatqcow2, raw, vmdk, iso, etc.
SizeDisk image size

Upload an Image

Open the Create Image dialog

Navigate to Project → Compute → Images and click Create Image.

Fill in image details

FieldDescription
Image NameDescriptive name (e.g., Ubuntu-24.04-LTS)
Image DescriptionOptional description
FileUpload a local image file (qcow2, raw, vmdk, iso)
FormatSelect format matching the file (usually QCOW2 - QEMU Emulator)
Architecturex86_64 (Intel/AMD 64-bit) or aarch64 (ARM)
Minimum Disk (GB)Minimum root disk size required to launch
Minimum RAM (MB)Minimum RAM required to launch
VisibilityPrivate (project-only) or Public (admin only)
ProtectedPrevent accidental deletion

Upload

Click Create Image. Status transitions: QueuedSavingActive.Large images (10+ GB) may take several minutes to upload and process.
Image reaches Active status and is immediately available for launching instances.

Instance Snapshots

Snapshots capture the current state of a running instance’s root disk as a reusable image.

Trigger from the Instance

Navigate to Project → Compute → Instances. In the instance row, open Actions → Create Snapshot.Enter a snapshot name and click Create Snapshot.
The instance is briefly quiesced during snapshot. For application-consistent snapshots on databases or transactional systems, quiesce the application first.

View snapshot

Navigate to Project → Compute → Images. Snapshots appear with type Snapshot and status Active when ready.
Add meaningful metadata to snapshots (e.g., app version, patch level) via Actions → Edit ImageImage Metadata.

Share Images

Share a private image with other projects without making it fully public.

Get the target project ID

The recipient project owner must provide their Project ID. They can find it in Identity → Projects or via CLI:
Get project ID
openstack project show <project-name> -c id

Share the image

In the image row, open Actions → Edit Image. This operation requires admin or image owner role.For project-level sharing, use the CLI:
Share image with another project
openstack image add project <IMAGE_ID> <TARGET_PROJECT_ID>

Recipient accepts the share

The recipient project must accept the share before the image appears in their list:
Accept shared image (run as target project)
openstack image set --accept <IMAGE_ID>

Image Metadata and Properties

Image properties control how instances launched from the image are configured at the hypervisor level. Navigate to Project → Compute → Images, click the image name, and select the Image Metadata tab to view and edit properties.
KeyExample ValueEffect
hw_disk_busvirtioDisk controller type (virtio recommended)
hw_vif_modelvirtioNetwork interface model
hw_machine_typeq35Machine type (q35 supports UEFI/PCIe)
os_secure_bootrequiredRequires UEFI Secure Boot on launch
os_typelinuxOS type hint for hypervisor
img_config_drivemandatoryForces config drive on all instances

Next Steps

Images User Guide

Full image service documentation including formats and conversion

Launch an Instance

Use an image to launch a new compute instance

Image Formats

Supported formats and conversion between them

Image Security

Signing, validation, and access control for images