Overview
What is Trezor Bridge?
Trezor Bridge is a small, secure helper application that runs on your computer and enables communication between your Trezor hardware wallet and browser-based apps (such as Suite or compatible web wallets). It replaces legacy WebUSB limitations with a background service that safely forwards messages to the device.
Why you need it
- Ensures reliable communication between browser and device.
- Improves cross-browser compatibility (Chrome, Firefox, Edge).
- Provides a secure, signed transport layer—no direct exposure of private keys to the web.
Install — Quick steps
- Download the latest Bridge installer for your OS from the official site.
- Run the installer and follow on-screen prompts.
- Restart your browser (and sometimes your computer) after installation.
- Connect your Trezor device via USB and unlock it with your PIN.
Command-line & verification
If you prefer checks or headless setups, verify Bridge is running by checking the local service port (default 127.0.0.1:21325
) and confirming process presence in your OS process list.
Troubleshooting
Common issues
- Bridge not detected — restart browser and reconnect USB.
- Conflicting USB drivers on Windows — update or re-install USB controller drivers.
- Firewall or antivirus blocking local connection — allow Bridge through firewall rules.
Advanced tips
- Use an official cable and a direct PC USB port (avoid hubs when possible).
- Check for updates for both device firmware and Trezor Suite/Bridge.
- Inspect browser console logs for bridge-related errors while reproducing the issue.
Security considerations
Bridge acts as a local-only helper. Always download from official domains and verify digital signatures when available. Never enter your recovery seed into a browser or app — Bridge only transmits signed commands to the device; the seed never leaves your hardware wallet.
Best practices
- Only install Bridge from official sources (links below).
- Keep your OS and antivirus up to date.
- Use a hardware firewall or host-level rules if you manage high-value setups.
Integration with Trezor Suite & web apps
Trezor Suite will automatically detect Bridge once installed. For web-based integrations, the Bridge API provides a simple, local JSON-RPC style transport. Developers can use official libraries and SDKs to talk to devices safely.