Vault Health Reports
Vault health reports can be used to evaluate the security of your Bitwarden individual or organization vault. Reports, for example the Reused Passwords and Weak Passwords report, are run locally on your client. This allows offending items to be identified, without Bitwarden ever having access to unencrypted versions of this data.
Most vault health reports are only available for premium users, including members of paid organizations (families, teams, or enterprise), but the Data Breach report is free for all users.
To run any vault health report for your individual vault:
Log in to the web vault.
Select Reports from the top navigation bar.
Select a report to run.
To run any vault health report for your organization vault:
Log in to the web vault and open your organization.
In your organization, open the Reporting tab and select Reports:
Select a report from the Reports section of the left menu.
The Exposed Passwords report identifies passwords that have been uncovered in known data breaches that were released publicly or sold on the dark web by hackers.
This report uses a trusted web service to search the first five digits of the hash of all your passwords in a database of known leaked passwords. The returned matching list of hashes is then locally compared with the full hash of your passwords. That comparison is only done locally to preserve your k-anonymity.
Once identified, you should create a new password for offending accounts or services.
Why use the first five digits of password hashes?
If the report was performed with your actual passwords, it doesn't matter if they were exposed or not, you would be voluntarily leaking it to the service. This report’s result may not mean your account has been compromised, rather that you are using a password that has been found in these databases of exposed passwords, however you should avoid using leaked and non-unique passwords.
The Reused Passwords report identifies non-unique passwords in your vault. Reusing the same password for multiple services can allow hackers to easily gain access to more of your online accounts when one service is breached.
Once identified, you should create a unique password for offending accounts or services.
The Weak Passwords report identifies weak passwords that can easily be guessed by hackers and automated tools that are used to crack passwords, sorted by severity of the weakness. This report uses zxcvbn for password strength analysis.
Once identified, you should use the Bitwarden password generator to create a strong password for offending accounts or services.
The Unsecured Websites report identifies login items that use unsecured (
http://) schemes in URIs. It's much safer to use
https:// to encrypt communications with TLS/SSL. To learn more, see using URIs.
Once identified, you should change offending URIs from
The Inactive 2FA report identifies login items where:
Two-factor authentication (2FA) via TOTP is available from the service
You have not stored a TOTP authenticator key
Two-factor authentication (2FA) is an important security step that helps secure your accounts. If any website offers it, you should always enable 2FA. Offending items are identified by cross-referencing URI-data with data from https://2fa.directory/.
Once identified, setup 2FA using the
Instructions hyperlink for each offending item:
The Data Breach report identifies compromised data (email addresses, passwords, credit cards, DoB, and more) in known breaches, using a service called Have I Been Pwned (HIBP).
When you create a Bitwarden account, you'll have the option to run this report on your master password before deciding to use it. To run this report, a hash of your master password is sent to HIBP and compared to stored exposed hashes. Your master password itself is never exposed by Bitwarden.
A “breach” is defined by HIBP as "an incident where data is inadvertently exposed in a vulnerable system, usually due to insufficient access controls or security weaknesses in the software". For more information, refer to HIBP's FAQs documentation.
If you are self-hosting Bitwarden, in order to run the data breach report in your instance you will need to buy an HIBP subscription key that will authorize you to make calls to the API, obtained here.
Once you have the key, open your
./bwdata/env/global.override.env and REPLACE the placeholders value for
globalSettings__hibpApiKey with your purchased API key:
For more information, see configure environment variables.