Flash an EVE-OS installer or live image

You must have a blank bootable storage device: either a USB drive or an SD card, depending on your edge node’s requirements.

You must have an EVE-OS image. If you don't, please see our guide to getting an EVE-OS image.

1. Plug in your USB drive.
2. Open your terminal.
3. List the storage devices connected to your machine to verify that your drive is recognized by your machine.

   diskutil list

4. Check the output from the previous step. Note that the title of your drive will include the word “external”. Remember this title. For example:

   /dev/disk4 (external, physical)

5. Unmount your drive.

   sudo diskutil umountdisk DISK_IDENTIFIER

   Example

   sudo diskutil umountdisk disk4

6. Locate your previously downloaded installer file. If you don’t have one, see Get an EVE-OS image.
7. Flash your EVE-OS image to your USB.

   sudo dd if=IMAGE_FILE of=DISK_IDENTIFIER bs=64m

   Example

   sudo dd if=installer.raw of=/dev/disk4 bs=64m

8. For EVE-OS installers: ensure that there are two volumes on your USB: EVE and INVENTORY

   diskutil list

   Example

   The output should look similar to the following:

   /dev/disk4 (external, physical):
      #:  TYPE NAME                          SIZE       IDENTIFIER
      0:  GUID_partition_scheme              *62.0 GB   disk4
      1:  Microsoft Basic Data EVE           1.0 MB     disk4s4
      2:  EFI EVE                            401.6 MB   disk4s1
      3:  Microsoft Basic Data INVENTORY     41.9 MB    disk4s5
          (free space)                       61.6 GB     -

   If the output does not contain EVE and INVENTORY, do not continue. Start again with a different USB drive. Your USB drive needs enough capacity to hold both volumes.

9. Eject your USB.

   diskutil eject DISK_IDENTIFIER

   Example

   diskutil eject /dev/disk4

10. Unplug your drive.
11. Proceed to our guide on installing EVE-OS.

1. Plug in your USB drive.
2. Open your terminal.
3. List the storage devices connected to your machine to verify that your drive is recognized by your machine.

   lsblk

4. Check the output from the previous step. Note that the title of your drive will indicate the “RM” (removable) is true (“1”). Remember the NAME value, “sdb” in the following example:

   NAME    MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
   sdb     8:16    1  16G  0  disk
   └─sdb1  8:17    1  16G  0  part /media/usb

5. Unmount your drive. You may need to unmount each of the volumes of the disk before unmounting the disk.

   sudo umount DISK_NAME

   Example: unmount volumes

   sudo umount /dev/sdb1
   sudo umount /dev/sdb2
   

   Example: unmount disk

   sudo umount /dev/sdb

6. Locate your previously downloaded installer file. If you don’t have one, see Get an EVE-OS image file.
7. Flash your image file to your USB.

   sudo dd if=IMAGE_FILE of=DISK_IDENTIFIER bs=64m

   Example

   sudo dd if=installer.raw of=/dev/sdb bs=64M

8. For EVE-OS installers: ensure that there are two volumes on your USB: EVE and INVENTORY

   lsblk

   If the output does not contain EVE and INVENTORY, do not continue. Start again with a different USB drive. Your USB drive needs enough capacity to hold both volumes.
9. Eject your USB.

   sudo eject DISK_NAME

   Example

   sudo eject /dev/sbd

10. Unplug your drive.
11. Proceed to our guide on installing EVE-OS.

We recommend using Rufus (in DD mode).

After you’re done, proceed to our guide on installing EVE-OS.

To flash a live EVE-OS image onto an SD card for Raspberry Pi devices, follow these steps.

1. Install the Raspberry Pi Imager.
2. Plug your SD-compatible USB drive into your local machine.
3. Insert your SD card into your USB drive’s SD port.
4. Open the Raspberry Pi Imager.
5. Choose which Raspberry Pi model you want to install EVE-OS onto from the Raspberry Pi Device dropdown.
6. Select Use Custom from the Operating System dropdown.
7. Select your USB drive from the Storage window.
8. Click Next.
9. Click No when prompted for OS customizations.
10. Click Yes, when warned that existing data on the SD card will be erased.
11. Click Continue to finish the flashing process.
12. Close the imager and eject your SD card.

You can now connect your flashed SD card to your edge node and boot into EVE-OS.