Glossary

Admin. The part of the WebUI about the server itself rather than any one app: its health, LibrePortal's settings, and who can reach what. See A tour of the WebUI.

Advanced. A switch that shows more technical detail in the WebUI, like each container's limits, and two extra apps. It doesn't change anything on the server. The opposite is Beginner. See Themes and appearance.

App Center. The part of the WebUI where you find and install apps, and look after all of them at once under Overview.

Automatic / Manual updates. Whether an app installs its new versions by itself, in the morning, or waits for you to press Update. See Updates.

Backup location. Somewhere backups are kept: a folder, a USB disk, another machine over SFTP, or cloud storage. See Backups and restore.

Catalogue. A signed list of extra apps, published separately from LibrePortal's releases, that you can Add to your App Center. See Tools and add-ons.

Companion app. An app that's offered alongside another when you install it, because the two go together, like SnappyMail with Stalwart. See Installing apps.

Configs. LibrePortal's own settings, backed up as a snapshot of their own. You need it to restore everything else. See Backups and restore.

Connect. LibrePortal Connect, a relay that lets you reach a server that's behind a router you can't open ports on. You can run your own. See LibrePortal Connect.

Container. A sealed box an app runs in, with only the files and network it's been given. LibrePortal uses Docker to run them. An app can be made of several containers, which the WebUI calls services.

Domain. A name you own, like example.com, that points at your server. You don't need one to start. See Domains and HTTPS.

Export (.lpapp). A single file holding one app, made with an app's Export button, to import on another LibrePortal. Handy for moving an app; not a backup.

Extras. Optional add-ons an app offers when you install it, like Talk or Office for Nextcloud. You can change them later with Add or Remove Extras on the app's Tools tab. See Installing apps.

Held until secured. What happens to a new app while LibrePortal is still making its admin account: it can only be reached from the server itself, so nobody else can get to it first. If the install can't finish that, the app stays held and says so. See Installing apps.

Improvements. Small, signed fixes to LibrePortal published between releases, each of which can be reverted. See Updates.

Instance. A second (or third) copy of the same app, with its own data, address and backups. See More than one copy of an app.

Local disk. The backup location every install starts with: the /libreportal-backups folder on the server itself. Good for undoing mistakes; no help if the disk dies.

Login Details. The username and password LibrePortal made for an app when it installed it. Press Welcome on the app's page to see them. See Installing apps.

Page Security. Whether an app's own port is served over plain HTTP or HTTPS. See App pages and settings.

Port. A numbered door on the server that an app answers on, like 4821. Most apps are given a random free one. Your apps' addresses on your network look like http://192.168.1.50:4821.

Private / Public. Who can reach an app: only your trusted places and devices, or anyone who has the address. The firewall enforces it. See Who can reach what.

Repository password. The password that encrypts a backup location. Without it, nobody can open those backups, including you. See Backups and restore.

Restic. The well-established open-source program LibrePortal uses to make encrypted backups that only store what's changed.

Rollback. Putting an app back to the snapshot taken just before an update. LibrePortal does it by itself when an update fails, and Roll back does it on request. See Updates.

Rootless Docker. Docker running as an ordinary user rather than as root, so an app that goes wrong has far less power over the machine.

Service. One running part of an app, like the app itself or its database. Each has a row on the app's Services tab.

Snapshot. One backup of one app (or of Configs) at one moment. LibrePortal keeps a history of them.

Storage location. A folder on a disk that LibrePortal can keep app data on. The system disk is the first; you can add more. See Disks and storage.

Subdomain. The first part of an address on your domain, like cloud in cloud.example.com. Each app gets its own when you have a domain.

Swap. Disk space the system uses as spare memory when memory runs short. Slow, but it stops apps being killed. See Disks and storage.

Task. One job LibrePortal does, like installing an app or taking a backup. The Tasks page lists them all with their full output.

Tools. Buttons on an app's page for everyday admin jobs, like adding a user. See Tools and add-ons.

Traefik. The app that gives your other apps proper addresses on your domain, with HTTPS. See Traefik.

Trusted places. Where you use the server from: your home network, addresses you add, and your devices on the LibrePortal VPN. Private apps answer only these. See Who can reach what.

Update window. The two hours each morning, 06:00 to 08:00, when apps set to Automatic install their updates.

VPN. The LibrePortal VPN: a private network between your server and your own devices, so your phone can reach private apps from anywhere. See The LibrePortal VPN.

WebUI. LibrePortal's web page, where you do everything. See A tour of the WebUI.

Works with. The list on an app's page of the other apps it connects to, and whether they're connected. See Apps that work together.