LibrePortal
Sponsor Get started

LibreVault

Password Vault

The server half of LibreVault, your password vault. Each server gets a vault of its own, locked so the server can never read it. You mostly use it through the LibreVault app, and the official Bitwarden apps open it too.

On this page
  1. At a glance
  2. What it's good for
  3. Installing it
  4. Signing in
  5. Quick settings
  6. Tools
  7. Good to know
  8. What the install asks
  9. Addresses and ports
  10. Settings
  11. In its config file
  12. Tools
  13. Works with
  14. Privacy and security
  15. What leaves this server
  16. What LibrePortal turns off
  17. Sources
  18. Under the hood

Good to know before you install

Signing in with Authelia only opens your account: you still type your master password to unlock the vault, because it never leaves your devices.

At a glance#

What it is
Password Vault Security
Where it opens
Password Manager On its own port at http://your-server:port, or librevault.your-domain once you have a domain
Updates
Automatic A backup is taken first, and it rolls back if the update fails
Backups
Included Part of the daily backup when that's switched on
Copies
As many as you like Run several copies, each with its own data
Needs
HTTPS

What it's good for#

This is where your passwords are kept on a server. You usually never open it directly. The LibreVault app on your phone and computer makes your vault here by itself, fills it, and keeps a synced copy on your device. The server only ever stores locked data and can never read it.

It is built on Vaultwarden, so the official Bitwarden apps and browser extensions can open the same vault. Use whichever you like.

Installing it#

You rarely need to. When the LibreVault app finds a server without a vault, LibrePortal installs this app on it for you. You can also install it from the App Center. It stays private by default: only your trusted places and devices can reach it, and sign-ups are off.

Signing in#

You do not sign in with a password LibrePortal made. Your vault is locked with a key made from your own password, on your own device, and the server never sees it. If you use Authelia, signing in with it only opens your account. You still type your password to unlock the vault, because that password never leaves your devices.

Quick settings#

At install, one choice: Open sign-ups, whether anyone who can reach the vault may make an account. With it off, the server refuses every sign-up from outside. The LibreVault app still makes its own account by itself, with no email. Other Bitwarden apps can only create an account while it is on, so turn it on briefly when you add one, then off again.

Tools#

Open the app's Tools tab.

  • Invite Someone: invite one email address to make an account. While Open sign-ups is off, turn it on first.
  • Move a Vaultwarden In: copy the accounts and passwords from the Vaultwarden app on this server into this vault. Vaultwarden is backed up first, the copy is checked, and things are put back if anything goes wrong. The old app is stopped and its data kept.
  • Move Back to Vaultwarden: the same in the other direction. Nothing is deleted on either side.
  • Register LibreVault, Register a Person's Vault and Remove a Person's Vault are used by the apps and by LibrePortal itself, not by hand. They make and remove accounts from inside the server, so a person you invite gets their own vault and a person you remove loses it.

Good to know#

  • Backups run every hour, because passwords matter. A good hourly backup stays quiet, and a failed one always alerts you. See Backups and restore.
  • A spare copy on LibreBackup. A LibreBackup can keep a read-only copy, so your passwords stay reachable if this server is down. See Keeping LibreVault safe.
  • Every vault belongs to one server. Nothing of one server's vault is stored on another.
  • Email: invitations and new-device alerts go through your mail server once it can mail the internet.

What the install asks#

When you install LibreVault, LibrePortal asks for a little more than usual before it starts:

  • Quick settings

Addresses and ports#

LibreVault has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one.

What it isWho can reach itWith a domain
Password Manager, Admin Panel Trusted places only librevault.your-domain

Settings#

These are LibreVault's own settings on its Config tab. The settings every app shares, like backups, updates and where its data lives, are explained in App pages and settings.

SettingWhat it doesStarts as
Outgoing Mail Server Your own mail server, for invitations and email-change codes. Empty uses the mail server on this machine if there is one. Empty
Outgoing Mail Port 587 for STARTTLS; 465 is TLS from the start. 587
Outgoing Mail Encryption How the connection to the mail server is secured.
Choices: STARTTLS, TLS from the start, None
starttls
Outgoing Mail Sender The address this server's mail comes from. Empty uses the username when it is an address. Empty
Outgoing Mail Username The account this server logs in to the mail server with. Empty
Allow Sign-ups When off, the server refuses every sign-up that comes over the network. The LibreVault app still makes its own account from inside. Turn on only while other people use Create account in a Bitwarden app. Off

In its config file#

A few more aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.

SettingWhat it doesStarts as
Name
CFG_LIBREVAULT_DISPLAY_NAME
What this app is called on your dashboards. Leave empty to use its usual name Empty
Show on the LibrePortal Dashboard
CFG_LIBREVAULT_SHOW_ON_DASHBOARD
Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard
Choices: true, false
true
Sign in only through single sign-on
CFG_LIBREVAULT_SSO_ONLY
Turns off email-and-password sign-in
Choices: true, false
false
Create Vaults by Signing In
CFG_LIBREVAULT_SSO_SIGNUPS_ALLOWED
Let people Authelia allows create their vault by signing in
Choices: true, false
false
Domain Support
CFG_LIBREVAULT_DOMAIN_SUPPORT
What this app can do with more than one address one
Domain Change
CFG_LIBREVAULT_DOMAIN_CHANGE
What moving it to another domain after install breaks warn
Extra Addresses
CFG_LIBREVAULT_ALIASES
Other addresses that serve this app in full, comma-separated Empty
Old Addresses
CFG_LIBREVAULT_REDIRECTS
Other addresses that send visitors on to this app, comma-separated Empty
Website icons
CFG_LIBREVAULT_SITE_ICONS
Whether the server may fetch each saved site's icon from that site, which tells the site your server looked it up
Choices: true, false
false
Detailed logs
CFG_LIBREVAULT_VERBOSE_LOGS
Whether this server writes its normal, chattier logs, including who connected, instead of only warnings and errors.
Choices: true, false
false
Debug logging for 24 hours
CFG_LIBREVAULT_DEBUG_LOGS
Turn on to see everything this server is doing while you look for a problem; it turns itself off after 24 hours.
Choices: true, false
false

Tools#

LibreVault's Tools tab has 6 buttons for jobs you'd otherwise need a terminal for. Each one runs as a task, so you can watch it on the Tasks page and read what it did. More about Tools.

Invite SomeoneTested on 1.37.3

Invite one email address to make an account. While Allow Sign-ups is off, the server refuses sign-ups from outside, so turn it on in Config while they join.

Asks for: Email
Move a Vaultwarden In

Copy the accounts and passwords from the Vaultwarden app on this server into this LibreVault server. Vaultwarden is backed up first, then stopped but left exactly as it was. Safe to run again.

Move Back to Vaultwarden

Copy the accounts and passwords from this LibreVault server into the Vaultwarden app on this server (installed first if needed). This server is backed up first, then stopped but left exactly as it was. Safe to run again.

Register LibreVault

Used by the LibreVault app, not run by hand: signs LibreVault's own account up on this vault from inside the server, with the sign-up read from standard input. Needs no email and no invitation.

Register a Person's Vault

Used by the LibrePortal server, not run by hand: makes one person's own LibreVault account from inside the server, when their app sends the sign-up. Only <their id>@librevault.invalid is accepted.

Remove a Person's Vault

Used when a person is removed from LibrePortal, not run by hand: deletes that person's own LibreVault account through the vault's admin API.

Works with#

These are the other apps LibreVault knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.

  • Email: Sends invitations and new-device alerts through your mail server. On by itself once that server can mail the internet, since an invitation then has to be opened from the email. LibrePortal sets this up by itself when both are installed.
  • Grafana: Shows dashboards for the apps that have one. works with every app
  • Prometheus: Collects metrics from the apps that can export them. works with every app
  • Uptime Kuma: Watches your apps and shows when one goes down. works with every app

Privacy and security#

All clear Vaultwarden keeps your passwords encrypted on your server. LibrePortal stops it fetching website icons, so it never tells the sites you save that your server asked.

What leaves this server#

  • The admin page can check GitHub for a newer version, only when you open it

What LibrePortal turns off#

  • Detailed logs and per-request access logging (switchable in Config)
  • Website icon downloads (switchable in Config)

Licence: AGPL-3.0. Audited: 21 October 2026. See the privacy of every app and the Promise.

Sources#

Under the hood#

  • It runs these images: vaultwarden/server:1.37.3@sha256:1587c45feaa479f1f5e8af3b00eded36bff77bcf1880cf8dbf0541706dd470e0, caddy:2.11.7-alpine@sha256:e70b164da81ef698b3ad19af799ea6086ce6d9e48ed4079eb9fe26f6fbf14ee5.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/dani-garcia/vaultwarden

Ports, settings, tools and connections on this page are read from LibrePortal v0.10.130's app catalogue each time the guide is built.

Next steps