Manage an Edge Application Image

Updated October 08, 2025 07:13

Introduction

This guide describes how to perform basic operations on Edge Application (App) Images, including adding and deleting app images.

Edge App Images are the raw container images or virtual machine images that you can use to create Edge Apps. The ZEDEDA Cloud Library serves as a way for you to manage images, such as upload, uplink, and more. You can pull these images to create your own Edge Apps or customize them as needed.

This is a series of articles. You will likely follow them in this order.

Prerequisites

- You have the SysManager role in your enterprise.
- You must have a datastore set up for your edge application.
- You have an Edge App Image.

Add an Edge App Image using the ZEDEDA GUI

Log in to the ZEDEDA GUI.
On left-hand side menu, hover over Library and click on Edge Apps Images
Click on the icon + to create a new edge app.
Fill in the Identity section.
- Name: Enter a Name for your Edge App image. This value can't be changed later.
- Title: Enter a Title for your Edge App image. You can change it at any time.
- Description: Enter a Description. You can use this to help other admins understand the purpose or any important details about the Edge App image.
- Image Type: Select Edge App, Docker Compose or Compose Runtime.
- Image Format: Select Container, ISO, QCOW2 or RAW.
- Image Architecture: This is the CPU type. Select AMD 64 or ARM 64.
If you selected Docker Compose for Image Type (or QCOW2 for Image Format), then configure the Uploading/Uplinking options:
- Select the Upload or Uplink radio button.
  - Upload: provide the image path for uploading.
  - Uplink: Note the following fields.
    - Image SHA256: the SHA-256 hash output of the file, such as: a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e
    - Image Size: the is the total file size for the image. Select the units from the dropdown (Bytes, KB, MB, GB, TB), and then specify the maximum size for the image.
    - Data Store: select up to 3 data stores from which the image will be downloaded.
    - Project: select the project(s) that the Edge App image belongs to.
    - Image Relative URL: the filename of the image, such as: my-image.img
After filling in all details, click the Add button.
A toast window appears, confirming your edge app image was successfully added.

Add an Edge App Image using the ZEDEDA CLI

Run the following command in the ZCLI to create the edge app image.

zcli image create <name> [--datastore-name=<datastore>] [--datastores=<datastore>...] (--arch=[AMD64|ARM64] | --patch-artifact-image) --image-format=[raw|qcow|qcow2|vhd|vmdk|ova|vhdx|container] [--image-url=<rel_url>] [--title=<title>] [--type=[Eve|Application|EvePrivate]] [--origin-type=<origin-type>] [--project-scope=<project-names>]

Example

zcli image create MY-IMAGE-V1 --datastore-name=ZEDEDA-DEMO --arch=AMD64 --image-format=qcow2 --title=MY-IMAGE-V1

Uplink your edge app image to associate the image entry in ZEDEDA Cloud with the file in the datastore, so ZEDEDA Cloud knows where to look for the file.

zcli image uplink IMAGE_NAME --datastore-name=DATASTORE_NAME --image-sha=SHA_256_VALUE --image-size=IMAGE_SIZE_IN_BYTES

Example

zcli image uplink MY-IMAGE-V1 --datastore-name=ZEDEDA-DEMO --image-sha=a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e --image-size=232476160

Delete an Edge App Image using ZEDEDA GUI

Log in to the ZEDEDA GUI.
On left-hand side menu, hover over Library and click on Edge Apps Images
Select the edge app images that you want to delete.
Click on the More icon (three vertical dots) in the top right.
Click Delete in the dialogue that appears.

Delete an Edge App Image using ZEDEDA CLI

Run the following command in the ZCLI to delete the edge app image.

zcli image delete [<name> | --match=<keyword>] [-f]

Example

zcli image delete MY-IMAGE-V1

Next steps

This is a series of articles. You will likely follow them in this order.

Was this article helpful?

2 out of 2 found this helpful