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

DIY Guide

Raspberry Pi

Raspberry Pi Board

Start9 is committed to ensuring that embassyOS is accessible. It will always be possible to build a comprable device to those sold in the Start9 Store. You can use the following guide to build your own Embassy One with readily available hardware. If any links are broken or sold out, please head to our forums.


There are several reasons you might prefer to build your own Embassy instead of purchasing one from us:

  1. You already own the necessary hardware and would like to re-purpose it.

  2. You want to save on shipping or import costs to your location.

  3. You do not trust Start9’s supply chain.

  4. You do not want to share your shipping address.

  5. You like building things.


The first thing you’ll need to do is gather the hardware and assemble it.


  1. Geekworm NASPi v2.0 ~$60 USD

    • It is important to get the 2.0 version as it has the ability to power back on automatically following a power outage.


  2. Raspberry Pi 4 (8GB RAM model) ~$75-200 USD

    • These have more than doubled in price in 2022. You may want to shop around, or buy used if need be.

  3. Internal SSD (1TB minimum) ~$80 USD+

    • 1TB minimum is recommended, however this all depends on your use-case.

    • 1TB is plenty for a full Bitcoin/Lightning stack OR a good amount of file storage, but not both if you want your device to be useful for years to come. 2TB or more is recommended if it is in your budget. You can always upgrade this later, and storage keeps getting cheaper.

  4. SD Card (32GB) ~$10 USD

    • A larger size is not necessary as it adds no benefit.

  5. Ethernet Cable (Cat5 or Cat6) ~$2 USD

    • You may have one laying around. Keep in mind the length you will require, e.g., how far away will your Embassy be from your router? 3-6ft is normally plenty.

  6. Speaker ~$5 USD

    • Not strictly required, but HIGHLY recommended.

  7. 2-Pin Male-to-Male Power Wire ~$5 USD

    • Required if using a speaker or Noctua fan.

  8. (Optional) Noctua NF-A4x10 5v Fan (Get all below) ~$15 USD

    • Recommended over the less-than-great Geekworm factory fan.

    • None of the included screws are long enough, so you will need 2 screws (M3-.50x12), available online or at any hardware store for <$1 USD.

    • 2x Male-to-Female jumper wires - unfortunately these only come in high quantities, so you may want to organize a group buy. ~$9

  9. (Optional) MicroSD to USB adapter

    • For flashing the OS. Not necessary if you have a way to mount an SD card already, such as an SD card slot on a laptop.

Estimated total cost:

  • ~$375-460+ with 1-2TB of storage


You can follow along with this written guide and/or our assembly video below:

Getting embassyOS

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

  • Download the latest release of embassyOS from our github, scroll to the Assets section, and download eos.tar.gz.

  • This will soon be available as a more convenient download from our website.

Installing embassyOS

Next, you’ll need to flash embassyOS onto a microSD card.

  1. Download balenaEtcher onto your Mac, Windows, or Linux 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 instructions.