* update compat build and add to os build process * copy to explicit file * fix paths and loading input * temp save docker images output * add docker config file to suppress warning * notes and first attempt of load image script * pr fixes * run as root, fix executable path * wip fixes * fix pool name and stop docker before umount * start docker again * reset docker fs * remove mkdir * load system images during embassy-init * add utils to make build * fix utils source * create system-images dir as root * cleanup * make loading docker images datadir agnostic * address PR feedback * rework load images * create shutdown channel on failed embassy-init run * pr feedback * fix import
Anyone can do it. No one can stop it.
EmbassyOS is a mass-market, graphical operating system designed to facilitate the discovery, installation, configuration, private self-hosting, and reliable operation of open-source software services and applications. It aims to eliminate trust and custodianship from personal computing.
⚠️ Caution
Some technologies supported by this software, such as Lightning, are considered in active development and might experience issues. Do not commit any funds you are not willing to lose. Be #reckless at your own risk.
Running EmbassyOS
There are multiple ways to obtain and begin using EmbassyOS.
💰 Buy an Embassy
This is the most convenient option. Simply buy an Embassy from Start9 Labs and plug it in. Depending on where you live, shipping costs and import duties may vary.
👷 Build your own Embassy
While not as convenient as buying an Embassy, this option is easier than you might imagine, and there are 4 reasons why you might prefer it:
- You already have a Raspberry Pi and would like to re-purpose it.
- You want to save on shipping costs.
- You prefer not to divulge your physical shipping address.
- You just like building things.
To pursue this option, follow this guide.
🛠️ Build EmbassyOS from Source
EmbassyOS can be built from source, for personal use, for free. A detailed guide for doing so can be found here.
❤️ Contributing
To contribute to the development of EmbassyOS, see here.
UI Screenshots
![]() |
![]() |
|---|---|
![]() |
![]() |



