Caution

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

Flashing¶

Getting embassyOS¶

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

Visit the latest embassyOS release page on Github to download an image of embassyOS. It is eos.tar.gz for Linux/Mac and eos.zip for Windows.

Warning

Make sure you have at least 16gb available on your drive.

Download the eos.tar.gz file and open a terminal in the directory you save it to
Extract with:
tar -xzvf eos.tar.gz
(Optional, but recommended) Verify the checksum against the one listed on GitHub:
sha256sum eos.img

Download the eos.tar.gz file
Right-click eos.tar.gz, click “open with,” then click Archive Utility to extract
(Optional, but recommended) Verify the checksum against the one listed on GitHub:
openssl dgst -sha256 eos.img

Download the eos.zip file
Right-click eos.zip and click “Extract all”
(Optional, but recommended) Verify the checksum against the one listed on GitHub:
Get-FileHash eos.img

Once you have the embassyOS image, 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 eos.img.
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.
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, insert it into your Embassy’s SD card slot, and continue to the Initial Setup or Update by reflashing instructions.