On a device or server

A more detailed step-by-step guide can be found in the user documentation.

[Raspberry Pi]

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 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.

Using Docker

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:

% sudo 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:

% sudo ubos-admin update

To remove all apps at a virtual host, and the site itself:

% sudo ubos-admin undeploy --host hostname

To back up all data from your apps:

% sudo ubos-admin backup --out all.ubos-backup

For details, refer to the UBOS user documentation.