Having trouble connecting your BitBox to Rabby? Don't worry. This guide provides quick solutions to the most common connection and transaction issues.


Before you start: Basic requirements

Most issues can be solved by checking these four things first.

  • Use the right browser: Rabby is a browser extension that requires Google Chrome or Brave.
  • Install BitBoxBridge: Make sure the latest version of BitBoxBridge is installed and running on your computer.
  • Close the BitBoxApp: The BitBoxApp must be completely closed for Rabby to connect with your BitBox.
  • Update your firmware: Ensure your BitBox has the latest firmware, which you can update through the BitBoxApp.

Rabby doesn't open or MetaMask opens instead

Problem: When you click to connect your wallet on a website, MetaMask opens by default, or nothing happens at all.

 

Solution: You need to set Rabby as your default wallet in your browser.

  1. Open and unlock the Rabby extension.
  2. A prompt to "Set Rabby as default wallet" may appear. Click it.
  3. If you don't see a prompt, you may need to temporarily disable other wallet extensions (like MetaMask) in your browser's extension settings.
  4. Refresh the website and try connecting again.
 

Rabby cannot detect your BitBox

Problem: Rabby does not find your BitBox when you try to connect it as a hardware wallet.

 

Solution: This usually happens because another program is blocking the connection.

  • Close the BitBoxApp: Ensure the app is not running, even in the background.
  • Check BitBoxBridge: Confirm it is running correctly.
    • Open a new tab in your browser and go to http://127.0.0.1:8178/
    • If the service is running, you will see a page with text confirming the "BitBoxBridge" version number.
  • Disable other extensions: Temporarily turn off other wallet extensions (e.g., MetaMask, Phantom) as they can interfere.
 

You are unable to sign a transaction

Problem: Your BitBox is connected, but you get an error when you try to sign a transaction on a platform like OpenSea.

 

Solution: Your BitBox firmware is likely outdated and does not support the specific type of transaction.

  1. Disconnect your BitBox and close your browser.
  2. Open the BitBoxApp.
  3. Connect and unlock your BitBox.
  4. Navigate to Device settings in the app and install any available firmware updates.