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.

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

[Beagle Bone Black]

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

[EC2 image]

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:

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