Run UBOS on a PC (64bit)
To install UBOS on a PC’s hard drive, first create a UBOS boot stick as described
in Run UBOS from a boot stick on a PC (64bit). Boot your PC with that boot stick, and
log on as
Make sure you have an internet connection. You can check with:
% ip addr
Identify the hard drive that you would like to install UBOS on. UBOS supports several configurations (see below). In the simplest case, your PC has only one hard drive, and you will wipe that hard drive and install UBOS instead.
Often, the name of your hard drive is
/dev/sda. To find the list of available drives, execute:
To install, execute:
% sudo ubos-install /dev/sda
Make sure you get the device name right, otherwise you might accidentally destroy the data on some other hard drive!
Also make sure your hard drive does not contain any valuable data; it will be mercilessly overwritten.
When complete, execute:
% sudo systemctl reboot
and remove your boot stick. UBOS should now be booting from the disk to which you installed it. If not, check your BIOS settings.
If your screen goes blank during the boot and doesn’t come back on, please refer to Booting UBOS on a PC starts out fine, but then the screen goes blank.
When the boot process is finished, log in as user
root. For password, see I need root.
Now: wait. UBOS needs to generate a few cryptographic keys before it is ready to use and initialize a few other things on the first boot. That might take a few minutes. To determine whether UBOS ready, execute:
% systemctl is-system-running
To speed up the process, generate lots of random activity, such as looking through the file system, and typing lots on the keyboard. You only need to do that once, on the first boot.
To speed up the key generation process, at the potential loss of some entropy, execute:
% sudo systemctl start haveged
Check that your PC has acquired an IP address:
% ip addr
Make sure you are connected to the internet before attempting to proceed.
Update UBOS to the latest and greatest:
% sudo ubos-admin update
You are now ready for Setting up your first Site and App.
If you have two hard drives and would like to use them in a RAID1-style configuration
(“duplicate data so one drive can fail”), simply add the second device name to
% sudo ubos-install /dev/sda /dev/sdb
If you do not want to erase your entire hard drive, but instead want to install UBOS on a partition, you can specify the partition device name instead of the drive device name. For details, refer to
% ubos-install --help