The BitBoxBridge is a small background application that allows your BitBox02 to communicate securely with supported third-party web wallets and browser-based services.
It acts as a secure connection layer between your browser and your BitBox02. Your private keys never leave the BitBox02. All sensitive actions, such as confirming transactions, still need to be verified directly on the hardware wallet.
The BitBoxBridge is especially useful when using browsers or web wallets that do not support direct USB communication with the BitBox02.
Why do I need the BitBoxBridge?
The BitBoxBridge helps your BitBox02 connect reliably to browser-based wallets and third-party web services.
Some browsers, such as Chrome and other Chromium-based browsers, support WebUSB. WebUSB can allow direct communication between the browser and your BitBox02. However, not all browsers support WebUSB, and support can differ depending on the browser, operating system, or wallet integration.
For this reason, we recommend installing the BitBoxBridge when using your BitBox02 with web wallets. It creates a stable communication channel and improves compatibility across different setups.
On Chromium-based browsers, the BitBoxBridge may not always be strictly required because WebUSB can be used instead. However, we still recommend installing it for the most reliable web wallet experience.
Once installed, the BitBoxBridge starts automatically and runs in the background. You usually do not need to open or interact with it manually.
Supported web wallets and services
You can use the BitBoxBridge with several third-party wallets and services. Each integration supports different assets, networks, or use cases.
| Wallet or service | Main use case | Notes |
|---|---|---|
| Rabby Wallet | Ethereum and EVM-compatible networks | Recommended for Ethereum, Polygon, Arbitrum, Optimism, Base, BNB Smart Chain, and other EVM networks. |
| MyEtherWallet | Ethereum, ERC-20 tokens, and NFTs | Also supports additional networks and assets depending on MyEtherWallet’s current functionality. |
| NuFi | Multi-chain wallet access | Supports assets on Cardano, Ethereum, and EVM-compatible chains. |
| AdaLite | Cardano | Lightweight web wallet for ADA and Cardano native tokens. |
| Bity | Buying, selling, and exchanging crypto | Swiss crypto broker supporting services such as Bitcoin and Ethereum transactions. |
| Website integrations without AOPP | Direct BitBox02 connection inside a website | The BitBoxBridge is needed when the website integrates the BitBox02 directly and the browser does not support WebUSB. |
Close the BitBoxApp completely before connecting your BitBox02 to a web wallet. The BitBox02 can only communicate with one application at a time.
How do I get the BitBoxBridge?
The BitBoxBridge is free software that you install on your computer.
You can download it from the official BitBox downloads page. For detailed installation instructions, see our guide:
→ How to install the BitBoxBridge.
After installation, the BitBoxBridge runs automatically in the background.
How can I check if the BitBoxBridge is running?
You can check whether the BitBoxBridge is running directly in your browser.
- Open your web browser.
-
Enter
http://localhost:8178orhttp://127.0.0.1:8178. - Check the page that opens.
If the BitBoxBridge is working correctly, you will see the message:
BitBoxBridge v1.6.0
GET /api/info
GET /api/v1/devices
GET/WS /api/v1/socket/:socket
api version = 1.6.0If you see this message, the BitBoxBridge is installed and running correctly.
Frequently asked questions
Do I need to open the BitBoxBridge manually?
No. After installation, the BitBoxBridge starts automatically and runs in the background.
You do not need to open it manually or interact with it during normal use.
Should I keep the BitBoxApp open when using a web wallet?
No. Close the BitBoxApp completely before connecting your BitBox02 to a web wallet.
The BitBox02 can only connect to one application at a time. If the BitBoxApp is still open, the web wallet may not detect your BitBox02.
Is the BitBoxBridge required on Chrome or Brave?
Not always.
Chrome, Brave, and other Chromium-based browsers can use WebUSB, which may allow direct communication with the BitBox02. However, we still recommend installing the BitBoxBridge because it provides a more consistent and reliable connection for supported web wallets.
Why is the BitBoxBridge more important on Firefox or Safari?
Firefox, Safari, and some other browsers do not support WebUSB in the same way as Chromium-based browsers.
Because of this, browser-based wallets usually need the BitBoxBridge to communicate with your BitBox02 on these browsers.
Do I need the BitBoxBridge for AOPP?
No. AOPP processes launch the BitBoxApp directly.
For example, if a service such as Pocket or Coinfinity uses AOPP, the process does not rely on the BitBoxBridge. Instead, the service opens the BitBoxApp to complete the address ownership proof.
When is the BitBoxBridge needed for website integrations?
The BitBoxBridge is needed when a website integrates the BitBox02 directly without using AOPP and the browser does not support WebUSB.
In simple terms:
| Use case | Is the BitBoxBridge needed? |
| AOPP process | No, the BitBoxApp is launched directly. |
| Web wallet on Firefox or Safari | Yes, usually required. |
| Web wallet on Chrome or Brave | Not always required, but recommended. |
| Direct website integration without AOPP | Required if the browser cannot use WebUSB. |
Does the BitBoxBridge access my private keys?
No. Your private keys never leave your BitBox02.
The BitBoxBridge only enables communication between your browser and your BitBox02. Sensitive actions still need to be confirmed directly on the BitBox02.
What should I do if the BitBoxBridge is not running?
First, check http://localhost:8178 or http://127.0.0.1:8178 in your browser.
If you do not see the message BitBoxBridge is running, reinstall the BitBoxBridge using the official installation guide:
→ How to install the BitBoxBridge.