Self-hosting

System Administrator Portal

The Bitwarden System Administrator Portal can be used to:

  • Check currently installed and latest available versions.

  • View environment configuration settings (for more information, see Configure Environment Variables).

  • View and delete registered users.

  • View and delete registered organizations.

note

Provisioned admins cannot view sensitive data that is protected (encrypted) in any user's or organization's vault.

Configure users

Configure access to the System Administrator Portal by editing the environment file, located at ./bwdata/env/global.override.env.

Adding an email address to adminSettings__admins=, located at the bottom of global.override.env, will provide access to the System Administrator Portal from that email address. You can provision multiple admins using this field, for example:

Bash
adminSettings__admins=john@example.com,bill@gmail.com,tom@example.com

These email addresses do not need to be registered with an account on your Bitwarden instance.

Configure SMTP mail server

The System Administrator Portal uses email to provide secure links for authentication. Therefore, you will need to configure your installation's SMTP mail server settings prior to attempting to log in to the portal. For more information, see Configure Environment Variables.

Access the portal

The System Administrator Portal for your instance is available at https://your.domain.com/admin.

The portal uses a secure means of passwordless authentication. When a user attempts to log in, a secure link is sent to their email address only if that email address is specified in adminSettings__admins=.

Clicking this temporary link will log that user into the System Administrator Portal. The link is active for 15 minutes following the login attempt.

Make a suggestion to this page

Contact Our Support Team

For technical, billing, and product questions.

Name*
Bitwarden account email*
Verify account email*
Product*
Are you self-hosting?*
Subject*
Message...*

Cloud Status

Check status

© 2024 Bitwarden, Inc. Terms Privacy Cookie Settings Sitemap

This site is available in English.
Go to EnglishStay Here