Skip to content

Installing the bPass Browser Extension

Get started with the bPass browser extension in just a few minutes. Follow this guide to install and set up the extension on your preferred browser.

Supported Browsers

The bPass extension supports all major browsers:

  • Google Chrome - Manual installation via developer mode
  • Mozilla Firefox - Manual installation via developer mode
  • Microsoft Edge - Manual installation via developer mode
  • Opera - Manual installation via developer mode (Chromium-based)
  • Brave - Manual installation via developer mode (Chromium-based)

Safari Support

Safari extension is currently in development and will be available soon. In the meantime, Safari users can use the web application directly.

Extension Distribution

The bPass extension is currently distributed directly from your bPass dashboard as a downloadable package. This ensures you always get the latest version compatible with your specific bPass instance.

Installation Instructions

Step 1: Download Extension from Dashboard

  1. Log into your bPass Dashboard
  2. Open your bPass web application

  3. Sign in with your credentials

  4. Navigate to Extension Download

  5. Look for the "Download Extension" or "Browser Extension" section

  6. Click the "Download" button to get the extension package

  7. Extract the Downloaded File

  8. Download will be a ZIP file (e.g., bpass-extension.zip)
  9. Extract the ZIP file to a permanent folder on your computer
  10. Remember the location where you extracted the files

!!! important "Keep Extracted Folder" Do not delete the extracted folder after installation. The browser references the extension files from this location. If you move or delete the folder, the extension will stop working.

Step 2: Install Extension

Install via Developer Mode

  1. Enable Developer Mode
  2. Open Chrome and go to chrome://extensions/

  3. Toggle "Developer mode" switch in the top-right corner

  4. Load Extension

  5. Click "Load unpacked" button
  6. Navigate to the folder where you extracted the extension

  7. Select the folder and click "Select Folder"

  8. Verify Installation

  9. The bPass extension should appear in your extensions list
  10. Click the puzzle piece icon in the toolbar

  11. Pin the bPass extension for easy access

  12. Grant Permissions

  13. The extension will request necessary permissions
  14. Click "Allow" to enable all features

Install via Developer Mode

  1. Open Debug Page
  2. Type about:debugging in the address bar

  3. Click "This Firefox" on the left sidebar

  4. Load Temporary Extension

  5. Click "Load Temporary Add-on..."
  6. Navigate to the extracted extension folder

  7. Select the manifest.json file and click "Open"

  8. Pin to Toolbar (Recommended)

  9. Right-click on the toolbar
  10. Select "Customize Toolbar"

  11. Drag the bPass icon to your preferred location

  12. Configure Permissions

  13. Review and accept the requested permissions
  14. All permissions are required for full functionality

Firefox Temporary Extension

Extensions loaded via "Load Temporary Add-on" are automatically removed when Firefox is restarted. You'll need to reload the extension each time you start Firefox until the extension is published to the Firefox Add-ons store.

Install via Developer Mode

  1. Enable Developer Mode
  2. Go to edge://extensions/

  3. Toggle "Developer mode" switch in the bottom-left corner

  4. Load Extension

  5. Click "Load unpacked" button
  6. Browse to the extracted extension folder

  7. Select the folder and click "Select Folder"

  8. Show in Toolbar

  9. Click the extensions menu (puzzle piece)

  10. Find bPass and toggle "Show in toolbar"

  11. Accept Permissions

  12. Grant the necessary permissions for full functionality

Install via Developer Mode

Since Opera and Brave use Chromium, they follow similar steps to Chrome:

  1. Enable Developer Mode
  2. Opera: Go to opera://extensions/
  3. Brave: Go to brave://extensions/

  4. Toggle "Developer mode" switch

  5. Load Extension

  6. Click "Load unpacked" or "Load unpacked extension"
  7. Navigate to the extracted extension folder

  8. Select the folder containing the extension files

  9. Pin Extension

  10. Access through the extensions menu

  11. Pin for easy access

  12. Grant Permissions

  13. Accept all requested permissions for full functionality

Initial Setup

After installing the extension, you'll need to connect it to your bPass vault:

Step 1: First Launch

  1. Click the bPass Icon in your browser toolbar
  2. Welcome Screen will appear with setup options
  3. Choose Setup Method:
  4. Connect to Existing Vault - If you already have a bPass account
  5. Create New Account - If you're new to bPass

Step 2: Connect to Your Vault

For Existing bPass Users

  1. Enter Server URL
  2. Input your bPass server address (e.g., https://bpass.yourcompany.com)

  3. For bPass Cloud users, use the provided URL

  4. Enter Credentials

  5. Email/Username: Your bPass account identifier

  6. Master Password: Your vault master password

  7. Two-Factor Authentication (if enabled)

  8. Enter your 2FA code when prompted
  9. The extension will remember your device (if configured)

For New Users

  1. Choose Deployment Option
  2. bPass Cloud: Use hosted service

  3. Self-Hosted: Install on your own infrastructure

  4. Create Account

  5. Email Address: Used for account recovery
  6. Master Password: Choose a strong, memorable password

  7. Confirm Password: Re-enter for verification

  8. Security Options

  9. Enable Two-Factor Authentication (recommended)
  10. Set Auto-Lock Timer: Choose inactivity timeout

Step 3: Import Existing Passwords (Optional)

The extension can import passwords from your browser's built-in manager:

  1. Import Prompt appears after initial setup
  2. Choose Import Source:
  3. Browser's saved passwords
  4. CSV file from another password manager

  5. Skip (import later from web application)

  6. Review Imported Data

  7. Check for duplicates
  8. Organize into folders

  9. Delete weak or unused passwords

  10. Disable Browser Password Manager (recommended)

  11. Prevents conflicts with bPass
  12. Extension will offer to do this automatically

Extension Permissions

bPass requests specific permissions to provide full functionality:

Required Permissions

Permission Purpose Why Needed
activeTab Read current page URL Auto-fill matching credentials
storage Store encrypted vault data Offline access to passwords
scripting Inject auto-fill scripts Fill login forms automatically
tabs Access to open tabs Multi-tab password management

Optional Permissions

Permission Purpose When Requested
<all_urls> Access all websites Auto-fill on any domain
clipboardWrite Copy to clipboard Copy passwords/usernames
notifications Show notifications Security alerts and updates

Security Note

bPass only requests permissions necessary for core functionality. The extension never tracks your browsing activity or collects personal data.

Verification & Security

Verify Installation

  1. Check Extension Icon appears in toolbar
  2. Open Extension Popup to verify connection
  3. Test Auto-Fill on a login page
  4. Check Sync Status with web application

Security Best Practices

  1. Download Only from Your Dashboard - Always download from your official bPass instance
  2. Verify Source - Ensure you're downloading from your legitimate bPass server
  3. Check Permissions - Review what access is granted during installation
  4. Keep Updated - Check your dashboard regularly for extension updates
  5. Report Issues - Contact support for any security concerns

Troubleshooting Installation

Common Issues

Extension Won't Load

  • Check Extraction - Ensure ZIP file was fully extracted
  • Verify Folder Structure - Make sure manifest.json is in the root of the extracted folder
  • Developer Mode - Confirm developer mode is enabled in browser
  • File Permissions - Ensure extracted files have proper read permissions
  • Browser Version - Ensure you meet minimum requirements
  • Clear Browser Cache - Remove cached data and retry
  • Restart Browser - Close and reopen browser completely

Download Issues

  • Check Network Connection - Ensure stable internet connection
  • Dashboard Access - Verify you're logged into the correct bPass instance
  • Browser Downloads - Check if download was blocked by browser security
  • File Corruption - Re-download if ZIP file appears corrupted

Can't Connect to Vault

  • Verify Server URL - Ensure correct address format
  • Check Internet Connection - Confirm stable connectivity
  • Firewall/Proxy Settings - May block extension communication
  • SSL Certificate Issues - Ensure valid HTTPS certificate

Import Fails

  • Browser Password Access - Grant permission to read saved passwords
  • Large Dataset - Break large imports into smaller chunks
  • Format Issues - Verify CSV format if importing from file
  • Timeout Issues - Retry with fewer entries per batch

Getting Help

If you encounter issues during installation:

  1. Check Documentation - Review this guide thoroughly
  2. Browser Console - Check for error messages (F12 → Console)
  3. Extension Settings - Verify configuration options
  4. Contact Support - Reach out with specific error details
  5. Community Forums - Ask questions in user community

Next Steps

After successful installation:

  1. Learn Extension Features - Explore all capabilities
  2. Configure Settings - Customize behavior and security
  3. Import Data - Migrate existing passwords
  4. Set Up Sharing - Collaborate with team members
  5. Mobile Access - Access vault on mobile devices

The bPass extension is now ready to secure your browsing experience! Start saving and auto-filling passwords to see how much time and security you'll gain.