Managing Sites and Apps
Obtaining information about your Device
Displaying the overall status of your Device
To show a summary of relevant information about your Device, execute:
% sudo ubos-admin status
Displaying the currently installed Sites and Apps
% sudo ubos-admin listsites
To find out about options for this command, add
--help as an argument to the command.
Displaying Site information
To show information about a currently installed Site with hostname
% sudo ubos-admin showsite --hostname <hostname>
Deploying or redeploying a Site with App(s) and Accessory/ies
Determining the list of available Apps and Accessories:
% pacman -Sl hl
Interactively creating a new Site with one or more Apps and Accessories
% sudo ubos-admin createsite
To secure this Site with SSL/TLS, invoke it instead as
sudo ubos-admin createsite --tls --self-signed(auto-generate a self-signed certificate)
sudo ubos-admin createsite --tls --letsencrypt(auto-provision a LetsEncrypt certificate). This only works if your Device is publicly accessible over the internet, and your Site’s hostname as a corresponding public DNS entry. (See also Setting up networking and DNS)
sudo ubos-admin createsite --tls(enter key and certificate files manually).
Undeploying one or more Sites
Make sure you do not accidentally undeploy the wrong Site, and always make backups first (see backup.md).
Undeploying a single Site
To undeploy a Site with hostname
<hostname> after making
a backup to file
backup.ubos-backup first, execute:
% sudo ubos-admin undeploy --backuptofile backup.ubos-backup --hostname <hostname>
Undeploying all Sites on a Device
% sudo ubos-admin undeploy --backuptofile backup.ubos-backup --all
Use with care.
Updating your Device
To update all code on your Device to the most recent UBOS version, execute:
% sudo ubos-admin update
You are advised to read UBOS Release Notes first.
% sudo ubos-admin backup --backuptofile backup.ubos-backup
% sudo ubos-admin backup --backuptofile backup.ubos-backup --hostname <hostname>