Skip to main content

​
Introduction

Your enterprise can designate a default EVE-OS image for each supported CPU architecture (AMD64 and ARM64). The default image is used to onboard new nodes that do not have a specific image version assigned. You can change the default at any time, but doing so does not automatically update existing nodes. When you add an EVE-OS image to your enterprise, Edge Infrastructure Services does not automatically mark it as the default. You must set the default explicitly each time you want to designate a new version. Default EVE-OS image management for a regular enterprise administrator is performed using ZCLI. There is no dedicated EVE-OS Images management page in the console for that role, and console image version selection appears only during node onboarding. See Onboard Nodes for the onboarding flow. Cloud-service and support administrators can also set the default from the console EVE-OS Images page under Admin Dashboard > Images > EVE-OS Images.

​
Prerequisites

​
View the Default EVE-OS Image

  1. Start a ZCLI session. See Get Started With ZCLI for authentication steps.
  2. Display the default image for your target architecture.
For AMD64:
For ARM64:

​
Set an EVE-OS Image as Default

  1. Start a ZCLI session. See Get Started With ZCLI for authentication steps.
  2. Mark your target image as default. Replace IMAGE_NAME with the version string and AMD64_OR_ARM64 with the appropriate architecture.
For example:
  1. Verify the new default.

​
Remove a Default EVE-OS Image

You cannot delete an EVE-OS image while it is set as the default. To replace the default, set a different image as the default first, then delete the old image if needed.
  1. Mark a different image as the new default using zcli image mark-latest (see the preceding section).
  2. Verify the new default is set.
  3. Delete the old image if needed. See Delete an EVE-OS Image.
If you attempt to delete an image that is currently set as the default, the operation fails with an error similar to:

​
Next Steps

Add a rootfs EVE-OS Image to Your Enterprise

Upload or uplink an EVE-OS rootfs image.

Delete an EVE-OS Image

Remove an image from your enterprise.

EVE-OS Management Overview

Overview of all EVE-OS image management operations.