Quick Start

For physical hardware, get the image

To run UBOS on the Raspberry Pi: Download this image for Raspberry Pi 1 and Zero (approx. 420MB), or this image for Raspberry Pi 2 (approx. 320MB), uncompress, and write to a USB stick in "raw" format.

To run UBOS on Beagle Bone Black: Download this image (approx. 320MB), 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. 470MB), uncompress, and write to a USB stick in "raw" format. Or this image for VirtualBox (approx. 520MB), uncompress, and use as the main virtual hard drive.

For 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, 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. Here is the list of currently available apps.

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.