Menu

Flashing

Getting embassyOS

After building your device, you need a copy of embassyOS.

Extracting the image

Linux

  1. Download the eos.tar.gz file and open a terminal in the directory you save it to

  2. Extract with:

    tar -xzvf eos.tar.gz
    
  3. (Optional, but recommended) Verify the checksum against the one listed on GitHub:

    sha256sum eos.img
    

Mac

  1. Download the eos.tar.gz file

  2. Right-click eos.tar.gz, click “open with,” then click Archive Utility to extract

  3. (Optional, but recommended) Verify the checksum against the one listed on GitHub:

    openssl dgst -sha256 eos.img
    

Windows

  1. Download the eos.zip file

  2. Right-click eos.zip and click “Extract all”

  3. (Optional, but recommended) Verify the checksum against the one listed on GitHub:

    Get-FileHash eos.img
    

Installing embassyOS

Once you have the embassyOS image, you will need to flash it onto a microSD card.

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

  2. Insert the microSD card into your computer, either directly or using an adapter.

  3. Open balenaEtcher.

    Balena Etcher Dashboard
  4. Click “Select Image” and select eos.img.

  5. Click “Select Target” and select your 32GB microSD card.

    Warning

    Be certain you have selected the correct target microSD card. Whatever target you select will be completely erased and replaced with embassyOS.

  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 the flash completes, you may remove the newly flashed micro SD card from any adapter, insert it into your Embassy’s SD card slot, and continue to the Initial Setup or Update by reflashing instructions.