On a device or 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. 410MB), or this image for Raspberry Pi 2 or Raspberry Pi 3 (approx. 410MB), uncompress, and write to a USB stick in "raw" format.
To run UBOS on the Marvell EspressoBIN:
Download this image (approx. 404MB), 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 or VMWare (approx. 670MB), uncompress, and use as the main virtual hard drive.
In the Cloud
To run UBOS on Amazon EC2:
Click on the logo and follow the Amazon wizard.
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
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.