start-os/build/README.old.md

Creating an 0.3.0 Image (Scripted version)

This guide assumes a linux environment

Text in this format are commands to run

1. a) Download ubuntu-21.04-preinstalled-server-arm64+raspi.img.xz

2. b) unxz ubuntu-21.04-preinstalled-server-arm64+raspi.img.xz to unzip

3. a) Run git clone https://github.com/Start9Labs/embassy-os to download the embassy-os repository

4. b) Plug in your 16GB microSD card. In this example, we are assuming it will be at /dev/mmcblk0

   • Find the location of your device with lsblk or fdisk -l

5. a) Run export OUTPUT_DEVICE=/dev/mmcblk0 where /dev/mmcblk0 is the sd card’s device name, be sure to change if yours differs

6. b) Run export LOOPDEV=$(sudo losetup --show -fP ubuntu-21.04-preinstalled-server-arm64+raspi.img) to set the .img file as a loop device environment variable

7. Run ./build/partitioning.sh You should see confirmation of write to disk

8. Run ./build/filesystems.sh You will see write progression twice, ignore the warning about lowercase labels

9. a) Store a product key as an environment variable in $PRODUCT_KEY, with export PRODUCT_KEY=test1234, obviously, this number is made up, but must be 8 alphanumeric characters, then:

10. b) echo $PRODUCT_KEY | sudo tee /mnt/product_key.txt to add it to the product_key.txt file.

11. c) sudo umount /mnt to unmount again

12. d) sudo mount /dev/mmcblk0p3 /mnt to mount the writable filesystem

13. a) Build EmbassyOS: Move into the EmbassyOS directory with cd embassy-os and Build embassy-os (NEEDS UPDATE – PULL LATEST CODE!!!) (for now, docker run --rm --privileged linuxkit/binfmt:v0.8, get rust-arm-cross.img and docker load < rust-arm-cross.img, then from appmgr dir: ./build-prod.sh)

14. b) Build UI: First, make sure you have git, node, and npm installed. Then, cd ui to enter ui dir, and run npm i -g @ionic/cli to install Ionic, npm i to install, then cd .. to return to the embassy-os directory

15. a) Run sudo ./build/copy.sh

16. b) cat ~/.ssh/id_ed25519.pub | sudo tee -a /mnt/root/.ssh/authorized_keys copy your ssh key over (assuming it is ~/.ssh/id_ed25519.pub)

17. c) sudo umount /mnt unmount once again

Time to remove your SD card and insert it into your hardware!! See our DIY guide if you have not yet put built your device.

9. a) Get IP (find by hacking) and visit x.x.x.x:80

10. b) ssh root@whateverIP and run sudo ./build/initialization.sh which you currently have to scp over from the embassy-os dir

11. Do the setup