Bitwarden Guides and Troubleshooting
Bitwarden password manager setup guides with step-by-step solutions for installation, import, two-factor authentication, sync issues, and self-hosting.
Navigate
Table of Contents
Installation Guide
Follow these steps to install Bitwarden Desktop on your system.
-
1
Download the installer
Visit the download page and select the package for your operating system.
-
2
Verify the file integrity
Compare the SHA-256 checksum of your download against the published hash before running the installer.
-
3
Run the installer
Follow the on-screen prompts. On macOS, drag the app to Applications. On Windows, accept the UAC prompt. On Linux, make the AppImage executable with chmod +x.
-
4
Create or log in to your account
Open Bitwarden, create a new account with a strong master password, or log in to an existing vault.
-
5
Install the browser extension
For autofill functionality, install the browser extension and link it to your desktop app or cloud vault.
Import Passwords from Another Manager
-
1
Export from your current manager
Export your passwords as a CSV or supported format from Chrome, Firefox, LastPass, 1Password, Dashlane, or KeePass.
-
2
Open Bitwarden import tool
In the web vault or desktop app, go to Tools > Import Data and select your source format.
-
3
Upload and confirm
Select the exported file, review the import preview, and confirm. Credentials appear in your vault within seconds.
-
4
Securely delete the export file
Exported CSV files contain unencrypted passwords. Delete them permanently after a successful import.
Enable Two-Factor Authentication
Adding 2FA to your Bitwarden account significantly strengthens your vault security beyond the master password alone.
-
1
Open account settings
Log in to your vault and navigate to Settings > Security > Two-step Login.
-
2
Choose your 2FA method
Options include authenticator app (TOTP), email, YubiKey OTP, Duo, and FIDO2 WebAuthn hardware keys.
-
3
Scan the QR code
For authenticator apps, scan the displayed QR code and enter the generated six-digit code to verify.
-
4
Save your recovery code
Store the two-step login recovery code in a safe location separate from your vault.
Browser Extension Setup
-
1
Install from the download page
Get the extension for your browser from the download page.
-
2
Pin the extension
Pin Bitwarden to your browser toolbar for quick access to autofill and vault search.
-
3
Log in and unlock
Enter your email and master password. Set a vault timeout that matches your security preferences.
-
4
Enable autofill on save
In extension settings, enable "Ask to add login" so new credentials are saved automatically when you sign up on websites.
Troubleshooting Sync Issues
Common Problems and Solutions
Vault not syncing across devices
Ensure you are logged into the same account on all devices. Check your internet connection and force a manual sync from Settings > Sync. Verify your vault is not locked on the source device.
Extension not connecting to desktop app
Open the desktop app and ensure it is unlocked. In extension settings, confirm the desktop integration option is enabled. Restart both the browser and desktop app if the connection fails.
Items missing after sync
Check that you are viewing the correct vault (personal vs organization). Items in the trash are not synced to other devices until restored. Review event logs if you are on a business plan.
Improve Your Vault Health
-
1
Run a vault health report
Open Reports in your vault and review weak, reused, and exposed passwords.
-
2
Replace weak passwords
Use the built-in password generator to create strong replacements for any flagged entries.
-
3
Eliminate password reuse
Assign unique passwords to every account. Reused credentials are the single largest risk factor in credential stuffing attacks.
-
4
Enable 2FA on critical accounts
Add two-factor authentication to email, banking, and cloud storage accounts identified in your vault.
Self-Hosting Overview
Self-hosting Bitwarden gives you complete ownership of your password management infrastructure.
-
1
Review system requirements
You need a Linux server with Docker and Docker Compose, a domain name, and SSL certificates.
-
2
Deploy with Docker
Use the official self-host installation script to pull containers and configure the environment.
-
3
Configure SSL and DNS
Point your domain to the server and configure HTTPS with Let's Encrypt or your own certificates.
-
4
Point clients to your server
In each Bitwarden client, set the custom server URL to your self-hosted domain before logging in.
Enterprise Deployment Best Practices
- ✓ Enable SSO with your identity provider before rolling out to all users.
- ✓ Configure SCIM for automated provisioning when employees join or leave.
- ✓ Enforce master password minimum length and complexity through organization policies.
- ✓ Require two-factor authentication for all organization members.
- ✓ Set up collections to group credentials by team, project, or department.
- ✓ Review event logs regularly for unusual access patterns.
Antivirus False Positive Warnings
If your antivirus flags Bitwarden during or after installation, this is almost certainly a false positive. Password managers routinely trigger heuristic detections because they hook into browsers and manage clipboard data.
Recommended Actions
-
1
Verify the SHA-256 checksum of your downloaded installer matches the official published hash.
-
2
Confirm you downloaded from the links on our download page.
-
3
Submit the file to your antivirus vendor as a false positive if checksums match.
-
4
Add Bitwarden to your antivirus exclusion list after verification.
-
5
Never disable antivirus entirely. Use targeted exclusions instead.
Bitwarden is open source and regularly audited. The installer contains no malware, adware, or unwanted bundled software.