mirror of
https://github.com/Start9Labs/start-os.git
synced 2026-03-26 10:21:52 +00:00
9a202cc124
* the only way to begin is by beginning * chore: Convert over 3444 migration * fix imports * wip * feat: convert volume * convert: system.rs * wip(convert): Setup * wip properties * wip notifications * wip * wip migration * wip init * wip auth/control * wip action * wip control * wiip 034 * wip 344 * wip some more versions converted * feat: Reserialize the version of the db * wip rest of the versions * wip s9pk/manifest * wip wifi * chore: net/keys * chore: net/dns * wip net/dhcp * wip manager manager-map * gut dependency errors * wip update/mod * detect breakages locally for updates * wip: manager/mod * wip: manager/health * wip: backup/target/mod * fix: Typo addresses * clean control.rs * fix system package id * switch to btreemap for now * config wip * wip manager/mod * install wip Co-authored-by: J H <Blu-J@users.noreply.github.com> * chore: Update the last of the errors * feat: Change the prelude de to borrow * feat: Adding in some more things * chore: add to the prelude * chore: Small fixes * chore: Fixing the small errors * wip: Cleaning up check errors * wip: Fix some of the issues * chore: Fix setup * chore:fix version * chore: prelude, mod, http_reader * wip backup_bulk * chore: Last of the errors * upadte package.json * chore: changes needed for a build * chore: Removing some of the linting errors in the manager * chore: Some linting 101 * fix: Wrong order of who owns what * chore: Remove the unstable * chore: Remove the test in the todo * @dr-bonez did a refactoring on the backup * chore: Make sure that there can only be one override guard at a time * resolve most todos * wip: Add some more tracing to debug an error * wip: Use a mv instead of rename * wip: Revert some of the missing code segments found earlier * chore: Make the build * chore: Something about the lib looks like it iis broken * wip: More instrument and dev working * kill netdummy before creating it * better db analysis tools * fixes from testing * fix: Make add start the service * fix status after install * make wormhole * fix missing icon file * fix data url for icons * fix: Bad deser * bugfixes * fix: Backup * fix: Some of the restor * fix: Restoring works * update frontend patch-db types * hack it in (#2424) * hack it in * optimize * slightly cleaner * handle config pointers * dependency config errs * fix compat * cache docker * fix dependency expectation * fix dependency auto-config --------- Co-authored-by: Aiden McClelland <me@drbonez.dev> Co-authored-by: Matt Hill <mattnine@protonmail.com> Co-authored-by: J H <Blu-J@users.noreply.github.com> Co-authored-by: Matt Hill <MattDHill@users.noreply.github.com>
Building StartOS
⚠️ The commands given assume a Debian or Ubuntu-based environment. Building in a VM is NOT yet supported ⚠️
Prerequisites
- Install dependencies
- Avahi
sudo apt install -y avahi-daemon- Installed by default on most Debian systems - https://avahi.org
- Build Essentials (needed to run
make)sudo apt install -y build-essential
- Docker
curl -fsSL https://get.docker.com | sh- 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+
- snap:
sudo snap install node - nvm:
nvm install --lts - https://nodejs.org/en/docs
- snap:
- NPM Version 7+
- apt:
sudo apt install -y npm - nvm:
nvm install --lts - https://docs.npmjs.com/downloading-and-installing-node-js-and-npm
- apt:
- jq
sudo apt install -y jq- https://stedolan.github.io/jq
- yq
- snap:
sudo snap install yq - binaries: https://github.com/mikefarah/yq/releases/
- https://mikefarah.gitbook.io/yq
- snap:
- Clone the latest repo with required submodules
ℹ️ You chan check latest available version here
git clone --recursive https://github.com/Start9Labs/start-os.git --branch latest
Build Raspberry Pi Image
cd start-os
make embassyos-raspi.img ARCH=aarch64
Flash
Flash the resulting embassyos-raspi.img to your SD Card
We recommend Balena Etcher
Setup
Visit http://start.local from any web browser - We recommend Firefox
Enter your product key. This is generated during the build process and can be
found in product_key.txt, located in the root directory.
Troubleshooting
- I just flashed my SD card, fired up StartOS, bootup sounds and all, but my browser is saying "Unable to connect" with start.local.
- Try doing a hard refresh on your browser, or opening the url in a private/incognito window. If you've ran an instance of StartOS before, sometimes you can have a stale cache that will block you from navigating to the page.
- Flashing the image isn't working with balenaEtcher. I'm getting
Cannot read property 'message' of nullwhen I try.
- The latest versions of Balena may not flash properly. This version here: https://github.com/balena-io/etcher/releases/tag/v1.5.122 should work properly.
- Startup isn't working properly and I'm curious as to why. How can I view logs regarding startup for debugging?
- Find the IP of your device
- Run
nc <ip> 8080and it will print the logs
- I need to ssh into my server to fix something, but I cannot get to the console to add ssh keys normally.
- During the Build step, instead of running just
make embassyos-raspi.img ARCH=aarch64runENVIRONMENT=dev make embassyos-raspi.img ARCH=aarch64. Flash like normal, and insert into your server. Boot up StartOS, then on another computer on the same network, ssh into the the server with the usernamestart9passwordembassy.
- I need to reset my password, how can I do that?
- You will need to reflash your device. Select "Use Existing Drive" once you are in setup, and it will prompt you to set a new password.