Flashing (x86)

This guide is for flashing embassyOS to a USB drive in order to install it to an x86 architecture device. This will include most desktops, laptops, mini PCs, and servers. For an up-to-date list of known-good hardware, please check out this forum post.


You will need a USB drive of at least 16GB in size

Getting embassyOS

  1. Visit the Github release page to find the latest embassyOS release.

  2. Select embassyos_amd64.iso from the “Assets” section at the bottom of the release.


Installing embassyOS

Once you have the embassyOS image, you will need to flash it onto your USB drive.

  1. Download balenaEtcher onto your Linux, Mac, or Windows computer.

  2. Insert the USB drive into your computer.

  3. Open balenaEtcher.

    Balena Etcher Dashboard
  4. Click “Select Image” and select the embassyos_amd64.iso file you just downloaded.

  5. Click “Select Target” and select your USB drive, checking the size to make sure it’s the correct drive.


    BE ABSOLUTELY CERTAIN you have selected the correct target flash drive. Whatever target you select will be COMPLETELY ERASED!!

  6. Click “Flash!”. You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal.

  7. After this completes, you may remove the newly flashed drive from your computer, insert it into the device you intend to install embassyOS onto. You will need to allow/prioritize “Legacy boot” from your BIOS. Look up your device or motherboard online for how to access the BIOS and make the change. This is not necessary when flashing the Embassy Pro.


    Always perfer the fastest available USB 3.0 port - typically this is blue or labeled “SS” (SuperSpeed)

  8. Finally, continue to the Initial Setup, Manual Update, or Reset Password instructions - depending on your need.