On a server
This page is for experienced Linux administrators. A detailed step-by-step guide can be found in the user documentation.
To run UBOS on the Raspberry Pi:
Download this image for Raspberry Pi Zero or the original Raspberry Pi 1 (approx. 470MB), or this image for Raspberry Pi 2 or Raspberry Pi 3 (approx. 470MB), uncompress, and write to a USB stick in "raw" format.
To run UBOS on Beagle Bone Black:
Download this image (approx. 411MB), uncompress, and write to a USB stick in "raw" format.
To run UBOS on an x86 PC:
Download this image for a physical PC (approx. 530MB), uncompress, and write to a USB stick in "raw" format. Or this image for VirtualBox (approx. 670MB), uncompress, and use as the main virtual hard drive.
In the Cloud
To run UBOS on Amazon EC2:
To run UBOS on Docker:
> alias ubos-docker-yellow='docker run -i -t --cap-add NET_ADMIN --cap-add NET_BIND_SERVICE --cap-add NET_BROADCAST --cap-add NET_RAW --cap-add SYS_ADMIN -v /sys/fs/cgroup:/sys/fs/cgroup:ro -e container=docker ubos/ubos-yellow /bin/init' > ubos-docker-yellow
In a Linux container
To run UBOS in a Linux container on a host that runs systemd:
Download this image for a Linux container (approx. 130MB), untar, and boot your container with:
sudo systemd-nspawn -b -n -D <directory>
For more details and other installation options, refer to the Installation section in the UBOS user documentation. It also describes how to run UBOS in a Linux container.
Then: Install one or more apps
Once booted, log in from the console as root, or via ssh using the UBOS staff. To install any app:
# ubos-admin createsite
and answer the questions. To obtain the list of currently available headless apps, execute:
$ pacman -Sl hl
To show installed apps and at which virtual hosts they run:
# ubos-admin listsites
To upgrade operating system, middleware, all installed apps, and perform any necessary data migrations and/or reboots:
# ubos-admin update
To remove all apps at a virtual host, and the site itself:
# ubos-admin undeploy --host hostname
To back up all data from your apps:
# ubos-admin backup --out all.ubos-backup
For details, refer to the UBOS user documentation.