You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at master.


Getting EmbassyOS

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

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 your downloaded copy of EmbassyOS.

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


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