Managing Default EVE-OS Images

This guide describes how to manage your enterprise’s default EVE-OS images. You’ll find instructions for viewing which images are currently marked as default; for marking a new image as the default, and for removing a default image.

Before you read ahead, you may want to be familiar with our EVE-OS images overview.

Prerequisites

You must have an EVE-OS image in your enterprise. If your enterprise doesn't have one, read our guide about adding an EVE-OS image to your ZEDEDA enterprise.

Considerations

Versions of EVE-OS marked as default in your enterprise are not necessarily the most recent versions of EVE-OS available. You need to track EVE releases and add new versions to your enterprise.

When you add an EVE-OS image to your enterprise, ZEDEDA Cloud does not automatically mark it as the default image. You must do that explicitly, every time you want to specify a new default image.

Your enterprise can have a default image for each architecture compatible with EVE-OS. They don’t have to be the same numbered version of EVE-OS.

View Default EVE-OS Images for Your Enterprise

Use the ZEDEDA GUI

1. Log in to the ZEDEDA GUI.
2. Hover over Library on the left side nav.
3. Select EVE-OS images.
4. Open the Summary panel at the top of the page.
   

   
   Your default images are displayed here. Look for the orange arrow, pointing to the file name.

Use the ZCLI

1. Log in to the ZCLI.
2. Use the following command in ZCLI to display the default image for AMD64 or ARM64.

   zcli image show --latest=AMD64

   or

   zcli image show --latest=ARM64

Mark an EVE-OS Image as Default

Use the ZEDEDA GUI

1. Log in to the ZEDEDA GUI.
2. Navigate to Library > EVE-OS Images.
3. Select the target image you want as the default.
4. Select More Actions (ellipsis at upper right).
5. Click Set as Default.

Use the ZCLI

1. Log in to the ZCLI.
2. Mark your target EVE-OS image as default.

   zcli image mark-latest IMAGE_NAME --image-arch=AMD64_OR_ARM64

   e.g.: zcli image mark-latest 11.0.5-lts-kvm-amd64 --image-arch=AMD64

3. Verify that you have a new default image by viewing your default images.

Removing a Default EVE-OS Image

Use the ZEDEDA GUI

1. Log in to the ZEDEDA GUI.
2. Navigate to Library > EVE-OS Images.
3. Select the target image you want as the default.
4. Select More Actions (ellipsis at upper right).
5. Click Delete. 
   Note: You will be unable to delete an image if it is currently set as the default.

Images marked as default can’t be deleted. If you want to delete an EVE-OS image that's marked as default, you must first mark a new, different image as the default.

If you try to delete an EVE-OS image that is currently marked as default, the operation will fail and you’ll get the following error.

Image delete failed: Conflict
[Error DependencyConflict: Dependent Entry exists]
[Error DependencyConflict: Image 7.4.1-kvm-amd64 is marked as default image for AMD64, can't be deleted]

To delete an EVE-OS image, see our guide to deleting EVE-OS images.

Next steps

If you want to update your edge nodes with a new default image, see our guide on updating edge nodes with the default version of EVE-OS.