Trezor Bridge — Overview
Trezor Bridge is part of the official Trezor ecosystem. It gives web applications a simple, consistent path to interact with hardware devices by exposing a local endpoint for device discovery and messaging. Bridge is lightweight, cross-platform, and is intended to be the recommended transport for most desktop/browser flows.
Installing Bridge
Obtain the Bridge installer from trezor.io/bridge. Run the package for your platform and follow prompts. If your browser still cannot detect the device, check firewall and privacy extensions that may block localhost connections. On macOS, you may need to allow the helper service in system preferences.
Security model
Bridge's security model focuses on limiting the service to a very small local interface. It does not store or transmit secrets. All signing is performed by the device. Clients should still display transaction details and ask for explicit, on-device approval for each action.
Developer guidance
When building integrations, detect Bridge presence and provide a clear install flow for users. Logging should exclude sensitive payloads. Sanitize and limit retries to avoid flooding the device or causing intermittent USB errors. Use user-friendly error messages that suggest concrete remediation steps.
Troubleshooting
- Bridge not running — restart the service, reinstall if necessary.
- Permission problems — check OS and browser USB permissions.
- Port collision — some environments block expected localhost ports; investigate with diagnostics.
Resources
Official Bridge page: trezor.io/bridge. Support: support.trezor.io.