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
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, orlibrevault.your-domainonce 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 is | Who can reach it | With 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.
| Setting | What it does | Starts 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.
| Setting | What it does | Starts as |
|---|---|---|
NameCFG_LIBREVAULT_DISPLAY_NAME |
What this app is called on your dashboards. Leave empty to use its usual name | Empty |
Show on the LibrePortal DashboardCFG_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-onCFG_LIBREVAULT_SSO_ONLY |
Turns off email-and-password sign-in Choices: true, false |
false |
Create Vaults by Signing InCFG_LIBREVAULT_SSO_SIGNUPS_ALLOWED |
Let people Authelia allows create their vault by signing in Choices: true, false |
false |
Domain SupportCFG_LIBREVAULT_DOMAIN_SUPPORT |
What this app can do with more than one address | one |
Domain ChangeCFG_LIBREVAULT_DOMAIN_CHANGE |
What moving it to another domain after install breaks | warn |
Extra AddressesCFG_LIBREVAULT_ALIASES |
Other addresses that serve this app in full, comma-separated | Empty |
Old AddressesCFG_LIBREVAULT_REDIRECTS |
Other addresses that send visitors on to this app, comma-separated | Empty |
Website iconsCFG_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 logsCFG_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 hoursCFG_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 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.
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.
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.
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.
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.
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.