Or, buy a pre-configured UBOSbox
from indiecomputing.com.

On a device or server

A more detailed step-by-step guide can be found in the user documentation. The links on this page are for the yellow release channel.

[Raspberry Pi]

To run UBOS on the Raspberry Pi:

Download this image for Raspberry Pi Zero or the original Raspberry Pi 1 (approx. 540MB), or this image for Raspberry Pi 2 or Raspberry Pi 3 (approx. 540MB), uncompress, and write to a USB stick in "raw" format.


To run UBOS on the Marvell ESPRESSObin:

Download this image (approx. 560MB), 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. 780MB), uncompress, and write to a USB stick in "raw" format. Or this image for VirtualBox or VMWare (approx. 780MB), uncompress, and use as the main virtual hard drive.

Once booted, log in from the console as root, or via ssh using the UBOS staff.

In the Cloud

To run UBOS on Amazon EC2:

Click on the logo and follow the Amazon wizard.

Once booted, log in via ssh using the private key you specified in the EC2 wizard, and account name shepherd, such as (replace IP address and name of your private key file):

% ssh shepherd@ -i id_rsa

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

Once booted, log in as root from the console.

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: Create a website that runs one or more web apps

Once logged in, create a website that runs one or more apps:

% sudo ubos-admin createsite

and answer the questions. To obtain the list of currently available web apps, and the available accessories, 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 --backuptofile all.ubos-backup

For details, refer to the UBOS user documentation.