Start9 Docs User Manual Flashing Flashing (Raspberry Pi)

Flashing (Raspberry Pi)¶

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

Note

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.

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.
(Optional, but recommended) Verify the checksum against the one listed on GitHub:
sha256sum embassyos_raspberrypi.tar.gz
Extract with:
tar -xzvf embassyos_raspberrypi.tar.gz

At the bottom of the page, under “Assets,” download the embassyos_raspberrypi.tar.gz file.
(Optional, but recommended) Verify the checksum against the one listed on GitHub by opening a terminal and entering:
openssl dgst -sha256 embassyos_raspberrypi.tar.gz
Right-click embassyos_raspberrypi.tar.gz, click “open with,” then click Archive Utility to extract.

At the bottom of the page, under “Assets,” download the embassyos_raspberrypi.zip file
(Optional, but recommended) Verify the checksum against the one listed on GitHub by opening a CMD terminal and entering:
Get-FileHash embassyos_raspberrypi.zip
Right-click eos.zip and click “Extract all”

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

Download balenaEtcher onto your Linux, Mac, or Windows computer.
Insert the microSD card into your computer, either directly or using an adapter.
Open balenaEtcher.
Click “Select Image” and select the .img file.
Click “Select Target” and select your microSD card.

Warning

BE ABSOLUTELY CERTAIN you have selected the correct target microSD card. Whatever target you select will be COMPLETELY ERASED!!
Click “Flash!”. You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal.
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.
Finally, continue to the Initial Setup, Manual Update, or Reset Password instructions - depending on your need.