Flash an EVE-OS image

Updated November 21, 2023 16:28

Before you can use your edge device with ZEDEDA Cloud, it must be running the EVE Virtualization Engine operating system (EVE-OS). To install EVE-OS onto your edge device, you'll need to complete three procedures: get an EVE-OS image, flash your EVE-OS image onto a portable drive, and finally install EVE-OS onto your device. This document explains how to flash an EVE-OS image.

When you're finished, you will have a bootable EVE-OS installer.

Prerequisites

You should have an EVE-OS image on your local system. If you don't, please begin with our guide to getting an EVE-OS image.

You'll need a blank bootable drive. For x86 devices, we recommend a USB device. For RPi devices, you'll need a MicroSD card.

Flash an image

There are two ways to flash the EVE-OS image onto a portable drive. You can:

Use balenaEtcher.
Use your terminal.

Warning: Flashing your USB will erase all of its existing data.

Use belenaEtcher

In the following procedure, you will use the belenaEtcher application to flash your EVE-OS image onto a USB device. If you encounter any problems with Etcher, refer to the official Etcher documentation.

Follow these steps:

Download Etcher, selecting the appropriate version for your operating system.
Open Etcher.
Click on Flash from file.
Select your EVE-OS image from your file system.
- installer.raw for EVE-OS images compatible with x86 devices.
- live.img for EVE-OS images compatible with RPi devices.
Plug in your USB. The Select target button in Etcher will show the connected drive.
Click Flash!
Check that are two directories on your USB: EVE and INVENTORY. Also check that the INVENTORY directory must be empty at this step.
- If your INVENTORY directory is not empty, check that you followed the previous steps correctly. If you did, contact ZEDEDA Support.
Unplug your drive and close Etcher. You are done!

Use your Terminal

Note that when you flash a USB using your terminal, you will not see a progress bar. The time required for your system to complete the operation depends on the specifications of your system. It could take a few minutes.

MacOS and Linux

Plug in your USB and launch your terminal application.
Run the following command.
```
diskutil list
```
Use the output from the previous step to verify that your USB is mounted onto your system. Note its identifier.
Unmount the target disk using the command. Substitute the identifier of your USB for IDENTIFIER_PATH in the command.
```
sudo diskutil umount IDENTIFIER_PATH
```

Flash your image to your USB.

sudo dd if=INSTALLER_FILE_PATH of=IDENTIFIER_PATH bs=64m

Check that are two directories on your USB: EVE and INVENTORY. Also check that the INVENTORY directory must be empty at this step.
- If your INVENTORY directory is not empty, check that you followed the previous steps correctly. If you did, contact ZEDEDA Support.
Eject your USB.
```
diskutil eject IDENTIFIER_PATH
```
Unplug your drive. You are done!

Next steps

You are ready to install EVE-OS onto your edge node. To do so, see our guide to installing EVE-OS.