boOS installer
An AArch64 operating system written from scratch (own assembler, language, linkers and kernel). This installer image boots through UEFI, runs a live system and installs itself to a disk.
Check the download: shasum -a 256 -c SHA256SUMS (macOS) or sha256sum -c SHA256SUMS (Linux).
Install with UTM (macOS, Apple Silicon)
- Download
installer.qcow2. - UTM: Create a New Virtual Machine → Virtualize → Other. Tick Skip ISO boot. Give it 4 GB of RAM, any number of CPUs, and a blank disk of 8 GB or more. Save.
- Edit the VM. Under Drives → New… → Import, choose
installer.qcow2and set its interface to VirtIO. - Check QEMU → UEFI Boot is ticked (the default). Leave the display (
virtio-ramfb), network and input (USB) at their defaults. - Start the VM. The blank disk is skipped (nothing to boot) and the installer starts.
- In the desktop open Applications → Installer, pick the blank disk, and confirm. (Or in the shell:
disksto see the names, theninstall vda -y. Check the name first: it erases that disk.) - When it says done, shut the VM down, delete the installer drive from the VM, and start it again. boOS boots from the installed disk; the first start formats the data partition.
Install with plain QEMU
qemu-img create -f raw boos-disk.img 8G qemu-system-aarch64 -M virt -accel hvf -cpu host -smp 4 -m 4G \ -drive if=pflash,format=raw,readonly=on,file=edk2-aarch64-code.fd \ -drive file=boos-disk.img,if=none,id=d0,format=raw -device virtio-blk-pci,drive=d0,bootindex=0 \ -drive file=installer.img,if=none,id=d1,format=raw -device virtio-blk-pci,drive=d1,bootindex=1 \ -device virtio-gpu-pci -device qemu-xhci -device usb-kbd -device usb-tablet \ -netdev user,id=n0 -device virtio-net-pci,netdev=n0
Then install as above. (edk2-aarch64-code.fd ships with QEMU; on Homebrew it is under /opt/homebrew/share/qemu/.)
On a USB stick
Any UEFI machine that boots AArch64 from removable media can start the image. Write it to a stick (this erases the stick; replace diskN with the stick's device, see diskutil list):
diskutil unmountDisk /dev/diskN sudo dd if=installer.img of=/dev/rdiskN bs=4m
The Raspberry Pi 4 does not boot this way (its USB ports need a driver boOS does not have yet).
After installing
- Software updates: Applications → Software update → Check (or
osupdate update) looks at updates.bo-system.com. - Run a command at every start: put it in
/data/startup.sh, one command per line (write /data/startup.sh mount sda lx, thenwrite -a /data/startup.sh …for more lines). - Help: type
helpin the shell or open Applications → Help.
Limits
boOS's own file system (/data) uses at most 2 GB of its partition. A USB tablet is supported only in QEMU's fixed report format. No GPU acceleration, no sandbox for Linux programs.
Files here are built from the boOS sources; the installer image and the kernel on updates.bo-system.com are the same build.