If you're encountering difficulties connecting your BitBox02 hardware wallet to Rabby, you're not alone. This troubleshooting guide addresses common issues and provides clear solutions to help you establish a secure connection between your BitBox02 and Rabby for interacting with Ethereum-based decentralized applications (DApps).​


Rabby does not open when attempting to connect to a DApp, or MetaMask opens instead

When trying to connect to a DApp, MetaMask may open instead of Rabby, or Rabby might not open at all. This typically occurs when Rabby isn't set as the default wallet, or MetaMask is overriding the connection.

Steps to resolve:

  1. Set Rabby as the default wallet:
    1. Open and unlock Rabby.
    2. At the bottom of the popup, click "Set Rabby as default wallet" and confirm.
    3. Refresh the DApp website and attempt to connect again.
  2. Disable MetaMask temporarily:
    1. Right-click the MetaMask icon in your browser toolbar and select "Manage extensions."
    2. Toggle the switch to disable MetaMask.
    3. Refresh the DApp website and try connecting with Rabby again.

BitBox02 is not detected by Rabby

If Rabby doesn't recognize your BitBox02 device, it might be due to BitBoxBridge not being installed or running correctly. This is especially relevant if you're using browsers other than Google Chrome or Brave, as these browsers require BitBoxBridge for communication between BitBox02 and web applications.

Steps to resolve:

  1. Ensure you're using a compatible browser:
    1. For optimal compatibility, use Google Chrome or Brave.
    2. If you're using a different browser, proceed to install BitBoxBridge.
  2. Download and install BitBoxBridge:
    1. Visit the official BitBoxBridge download page.
    2. Download the latest version suitable for your operating system.
    3. Install BitBoxBridge on your computer.
  3. Verify that BitBoxBridge is running:
    1. Open your browser and navigate to http://127.0.0.1:8178/.
    2. If BitBoxBridge is running correctly, you should see a page displaying information about the BitBoxBridge service.
    3. If Rabby doesn't recognize your BitBox02 device, it might be due to BitBoxBridge not being installed or running correctly.

Unable to unlock BitBox02 without BitBoxApp

Attempting to unlock your BitBox02 through BitBoxApp while connecting with Rabby can cause issues.

Steps to resolve:

  1. Close BitBoxApp completely.
  2. Initiate the connection process through Rabby.
  3. When prompted, unlock your BitBox02 device directly.

Unable to sign transactions on platforms like OpenSea

If you're unable to sign transactions on platforms like OpenSea, it may be due to outdated BitBox02 firmware lacking support for certain smart contracts.

Steps to resolve:​​

  1. Download and install the latest BitBoxApp
  2. Open the BitBoxApp.
  3. Connect and unlock your BitBox02.
  4. Navigate to "Device settings" and check for firmware updates.
  5. If an update is available, follow the on-screen instructions to install it.