Introduction
Trezor Bridge is the official middleware that enables secure communication between a web browser (or web wallet) and your Trezor hardware wallet. It ensures that private keys remain protected while enabling seamless interaction via web apps.
What & When You Need It
Bridge is required when using Trezor’s web interface or compatible third-party web wallets in browsers that lack full WebUSB support. It acts as a secure proxy for USB communication, translating browser calls into device commands.
How It Works
- A background service listens for USB device connections.
- Exposes a local API (HTTP/WebSocket) for browsers to use.
- Translates requests securely to the Trezor device.
- All signing remains on-device; Bridge never sees private keys.
- Access is controlled and whitelisted to prevent unauthorized apps.
Installing & Using Bridge
- Download the official Bridge installer for your OS.
- Install and allow it to run as background service.
- Connect your Trezor device via USB.
- Open Trezor web app / interface — it should detect Bridge.
- Approve the connection on your device and start using features.
- For sensitive operations, confirm on the hardware device.
Security Best Practices
- Only install from official Trezor sources.
- Verify installer signatures or checksums.
- Never enter your seed phrase into any software.
- Confirm every transaction on your Trezor device screen.
- Keep Bridge, firmware, and apps updated.
- Allow only trusted domains to connect via Bridge.
Important: Bridge does not store your private keys or seed. All key operations happen on the Trezor hardware only.
Troubleshooting & Common Issues
| Issue | Cause | Solution |
|---|
| No device detected | Bridge not running or browser blocked access | Restart Bridge / browser, check permissions |
| Installer blocked | OS security restrictions | Allow verified publisher or adjust security settings |
| Version mismatch | Using old installer | Download and install latest version |
| Device connects but no signing | App/browser compatibility issue | Try alternate browser or clear cache |