On a device or server
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 email@example.com -i id_rsa
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.