LibrePortal
Sponsor
Install

People and invites

For the person running the server, how to add people and invite their phones from the LibrePortal app. For the person invited, how to join and what the simple app shows.

On this page
  1. For the admin: People
  2. What an invite gives
  3. For the invited: Join with an invite
  4. The simple app

For the admin: People#

Each server has a People section. It shows the people on your LibrePortal, the apps each can open, and their devices.

The People page of a server named Homebox. The owner is marked Admin with an Invite a device button. A second person, Lena, lists Nextcloud and Gitea and has a phone shown as connected, with Remove and Invite a device buttons. Below, an Add a person card has Username and Name shown fields.
A server's People page, with test people.
  • Add a person. Type a username and, if you like, a name. The server makes a password and shows it once. Leave Give them every app ticked, or untick it to choose their apps later.
  • Invite a device. Press it beside a person. The app shows a QR code, a share link and a copy button. The code works once.
  • Remove. Shows first what would be cut off: their private-network devices, their signed-in apps and their open invites.

Each device shows whether it is connected, and when its key was last refreshed.

Needs LibrePortal 0.10.59

People and invites need LibrePortal 0.10.59 on the server. On an older one, the section says so.

What an invite gives#

An invited device gets exactly that person's own access: their own apps, on the server's private network. Never admin rights, and never SSH. The person's device makes its own VPN key, and the private half never leaves it. The same page in the web panel is covered in Accounts and people.

For the invited: Join with an invite#

Someone running a server sent you a link or a QR code.

  1. Install the app. You do not need a Vaultwarden vault.
  2. Press I have an invite on the first screen.
  3. Scan the QR code, or paste the link. A link starts with libreportal://invite.
  4. Press Join. That is all.

The app signs you in as you and joins your phone to the server's private network. It asks for nothing else.

The simple app#

If every server in the app is one you joined, the app turns into the simple one. You see only what you need:

A server named Home server, signed in as Lena, member. Your apps lists Cloud and Code, each with an Open button. A Private network card says it reaches only what you were given. A Profile card has a Change password button.
What an invited person sees, with a test person.
  • Your apps, each with an Open button. Some sign you in with one tap.
  • Private network, which reaches only what you were given. You can switch the VPN on and off.
  • Your profile, notifications and appearance.

There is no Add a server, and the settings list is short: Notifications, App updates, Permissions, Privacy, Appearance and About.

Coming next

A member's phone cannot yet refresh its own key from the app. That needs a server route that does not exist yet, so the app does not offer it.

See also Connect the app for the older pairing code, and Phone apps and privacy.

Next steps

Accounts and peopleAdd each person once, give them their apps and choose their access.Connect the appPair a phone or computer with your server by QR code, link or code.Phone apps and privacyWhat each LibrePortal phone app connects to and what it keeps.