Flashing (Raspberry Pi)

This guide is for flashing embassyOS to a micro SD card in order to install it on a Raspberry Pi.


You will need a micro SD card of at least 16GB in size, 32GB recommended

Getting and Extracting the embassyOS Image

Visit the Github release page to find the latest embassyOS release. Select your OS below to get the correct Asset and extraction directions.

  1. At the bottom of the page, under “Assets,” download the embassyos_raspberrypi.tar.gz file and open a terminal in the directory you save it to.

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

    sha256sum embassyos_raspberrypi.tar.gz
  3. Extract with:

    tar -xzvf embassyos_raspberrypi.tar.gz

Installing embassyOS

Once you have extracted the embassyOS .img file, 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 the .img file.

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


    BE ABSOLUTELY CERTAIN you have selected the correct target microSD card. 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 the flash completes, you may remove the newly flashed micro SD card from any adapter, and insert it into your Embassy’s SD card slot.

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