start-os/build/README.md

Building Embassy OS

⚠️ The commands given assume a Debian or Ubuntu-based environment. Building in a VM is NOT yet supported ⚠️

Prerequisites

1. Install dependences

• Avahi
  • sudo apt install -y avahi-daemon
  • Installed by default on most Debian systems - https://avahi.org
• Docker
  • sudo apt install -y docker.io
  • https://docs.docker.com/get-docker
  • Add your user to the docker group: sudo usermod -a -G docker $USER
  • Reload user environment exec sudo su -l $USER
• Prepare Docker environment
  • Setup buildx (https://docs.docker.com/buildx/working-with-buildx/)
  • Create a builder: docker buildx create --use
  • Add multi-arch build ability: docker run --rm --privileged linuxkit/binfmt:v0.8
• Node Version 12+
  • sudo snap install node
  • https://nodejs.org/en/docs
• NPM Version 7+
  • sudo apt install -y npm
  • https://docs.npmjs.com/downloading-and-installing-node-js-and-npm
• jq
  • sudo apt install -y jq
  • https://stedolan.github.io/jq

2. Clone the repo, move into it, and bring in required submodules

   git clone --recursive https://github.com/Start9Labs/embassy-os.git
   cd embassy-os
   git submodule update --init --recursive
   

Build

make

Flash

Flash the resulting eos.img to your SD Card (16GB required, any larger is neither necessary, nor advantageous)

We recommend Balena Etcher

Setup

Visit http://embassy.local from any web browser

We recommend Firefox