An Image is a reference to a VM disk image or container image stored in a Datastore. Images are versioned, reusable objects that are referenced by App Bundles at deployment time. ZEDEDA Cloud does not store the image binary itself; it stores the metadata (location, format, hash) and instructs EVE-OS to fetch the image from the Datastore when needed.

• Supported formats: qcow2, raw, vmdk (for VMs); OCI container images (for containers)
• An image record contains: datastore reference, relative path within the datastore, format, and expected SHA256 hash
• Images are versioned and can be reused across multiple App Bundle definitions
• Once downloaded to a node, images are cached in the EVE-OS local volume pool

1. Navigate to Objects > Images
2. Click Add Image
3. Select the Datastore that holds the image file
4. Enter the image relative URL (path within the datastore)
5. Select the image format (qcow2, raw, vmdk, OCI)
6. Enter the SHA256 hash for integrity verification
7. Click Save

resource "zedcloud_image" "ubuntu_vm" {
  name           = "ubuntu-22-04"
  image_type     = "IMAGE_TYPE_EVE"
  datastore_id   = zedcloud_datastore.s3_store.id
  image_rel_url  = "vms/ubuntu-22.04.qcow2"
  image_format   = "QCOW2"
  image_sha256   = "abc123..."
  project_id     = zedcloud_project.workshop.id
}

POST /v1/images
{
  "name": "ubuntu-22-04",
  "imageType": "IMAGE_TYPE_EVE",
  "datastoreId": "<datastore_id>",
  "imageRelUrl": "vms/ubuntu-22.04.qcow2",
  "imageFormat": "QCOW2",
  "imageSha256": "abc123...",
  "projectId": "<project_id>"
}

1. When an App Instance referencing this image is deployed to the node, the controller sends a download instruction to EVE-OS
2. EVE-OS authenticates to the Datastore and downloads the image using the relative URL
3. The downloaded image is verified against the expected SHA256 hash; a mismatch aborts the download
4. The image is stored in the EVE-OS local volume pool (typically on the data partition of the node)
5. Subsequent app instances on the same node referencing the same image reuse the cached copy

• Datastores
• EVE-OS Images
• Edge Apps