Administrator documentation


  1. UBOS Linux installation
    1. Run UBOS on a PC (64bit)
    2. Run UBOS from a boot stick on a PC (64bit)
    3. Run UBOS in a VirtualBox virtual machine (64bit)
    4. Run UBOS with Docker
    5. Run UBOS on an Amazon Web Services EC2 virtual server
    6. Run UBOS on Raspberry Pi 2 or 3
    7. Run UBOS on Raspberry Pi 4
    9. Run UBOS on ESPRESSObin
    10. Run UBOS in a Linux container on a PC (64bit)
    11. Run UBOS in an ARMv7 Linux container (e.g. Raspberry Pi 2, 3, 4)
    12. Run UBOS in an AArch64 Linux container (e.g. Marvell ESPRESSObin)
  2. Setting up your first Site and App
  3. Setting up UBOS Mesh
  4. Setting up networking and DNS
  5. How to create a website secured by SSL/TLS
  6. How to set up a website as a Tor hidden service
  7. Managing Sites and Apps
  8. Backup and restore
  9. Upgrading and keeping your Device current
  10. The UBOS Staff
  11. App-specific notes
    1. Reliably send e-mail via Amazon Web Services' Simple E-mail Service: amazonses
    2. Static website hosting with rsync-based upload: docroot
    3. Notes on Mastodon
    4. Notes on Nextcloud
    5. Notes on Redirect
    6. Notes on Wordpress
  12. Device-specific Notes
    1. ESPRESSObin
    3. Raspberry Pi
  13. Advanced management
    1. Enabling non-standard package repositories
    2. Migrating from one App to another
    3. Pinning resources
  14. FAQ, HOWTOs and Troubleshooting
    1. "Package not found error" when installing a new App or Accessory
    2. A UBOS container comes up degraded
    3. Booting UBOS on a PC starts out fine, but then the screen goes blank
    4. Can I use UBOS without purchasing a domain name?
    5. Cannot access MySQL database. File missing: /etc/mysql/root-defaults-ubos.cnf
    6. Cannot boot UBOS from boot stick on a PC
    7. Cannot connect to the public internet from a UBOS container
    8. Cannot create a temporary backup; the backup directory is not empty
    9. Failed to create file /sys/devices/system/cpu/microcode/reload
    10. How are the various UBOS images different from each other?
    11. How can I install more than one web App on the same Device?
    12. How do I report a bug?
    13. How do I set up WiFi?
    14. How to enable non-standard Package Repositories
    15. How to get help
    16. How to log into your UBOS Device
    17. How to modify the configuration of your Site
    18. How to report a bug or issue
    19. How to use Pagekite to reach your UBOS Device behind a firewall
    20. How to use SSH
    21. How to use Storj/Tardigrade on UBOS
    22. I need a Package that isn't in UBOS
    23. I need root
    24. I own a domain name, and I'd like to use it for my UBOS Device. How do I do that?
    25. I want to move from one device to another, or from/to the cloud to/from a device
    26. I want to run ssh on a non-standard port
    27. I'm running out of disk space, what now?
    28. Installing a new Package or updating fails with a message about "invalid or corrupted package" or "key is disabled"
    29. Installing a new Package or upgrading fails with a message about "unknown trust"
    30. Is it safe to have my Site accessible from the public web?
    31. My non-English keyboard layout is all screwed up
    32. My SD card is much larger than the UBOS image. How do I use the rest of the space?
    33. Nothing happens when UBOS is supposed to be booting
    34. Problems with "IPv6 Packet Filtering Framework"
    35. UBOS is in a "degraded" state
    36. ubos-admin status reports "Systemd unit ... has failed"
    37. Updating UBOS fails with lots of error messages containing "Unrecognized archive format"
    38. Verify your downloaded UBOS image
    39. What is the default "root" password?
    40. What text editor can I use on UBOS?
    41. Why did you derive UBOS from Arch Linux, and what is the relationship between UBOS and Arch?
    42. Why does UBOS ask for a domain name when installing a new Site?
    43. Why is it called UBOS?
    44. Writing a disk image to a USB stick or SD card
  15. Command reference