What is Trezor Bridge?

Trezor Bridge is a local helper application that enables communication between your Trezor hardware device and web browsers. Instead of relying on browser plugins or native USB drivers, Bridge runs on your computer and provides a secure, browser-agnostic channel for the Trezor web client to talk to your device.

Key features

• Cross-browser compatibility: Works with Chrome, Firefox, Edge, and other major browsers.
• Platform support: Native installers for Windows, macOS, and Linux.
• Secure local connection: Only accepts connections from trusted origins; no remote access.
• Automatic updates: Optional background updates keep Bridge current with security patches and new features.

Install & setup (quick)

Before you begin: make sure you have your Trezor hardware device and a secure internet connection. Never share your PIN or recovery seed with anyone.

1. Download the correct installer for your OS from the official Trezor website.
2. Run the installer and follow the on-screen instructions. You may be asked to allow a system service for Bridge to run in the background.
3. Open your browser and navigate to the web wallet (for example, Trezor Suite or the official web client).
4. Connect your device via USB-C or micro-USB. Your browser will request a secure connection through Bridge — accept it on both the device and the browser prompt.

// macOS example: start Bridge from terminal (if needed)
open /Applications/Trezor\ Bridge.app

// Windows: run the installer .exe and allow the service

Troubleshooting

Most connection problems are caused by one of these issues: outdated Bridge version, browser blocking the connection, or a faulty USB cable.

• Bridge not installed: Re-download the installer and run with admin privileges.
• Browser prompts not appearing: Disable strict privacy plugins temporarily and try again.
• Device not recognized: Try a different USB cable or port; avoid USB hubs when possible.
• Linux users: Ensure proper udev rules are installed (the installer usually adds them). You may need to log out and back in.

Security & privacy

Trezor Bridge was designed with a security-first mindset. Bridge only accepts connections from web pages that present a valid origin matching approved Trezor web clients. The device itself performs all sensitive operations — private keys never leave the hardware.

Additional recommendations:

• Only download Bridge from the official Trezor website.
• Verify installer checksums if you are in a high-risk environment.
• Keep your OS and browser up to date to benefit from the latest security patches.

Developer notes (optional)

If you build web apps that integrate with Trezor, Bridge provides a simple WebUSB fallback. Use the official libraries and follow recommended origin whitelisting to ensure only authorized pages can access the device.

// Example: detect Bridge availability
if (window.TrezorConnect) {
  // use TrezorConnect for device actions
}

Frequently asked questions

Do I need Bridge if I'm using Trezor Suite app?

No. Trezor Suite (desktop) communicates with the device directly and doesn't require Bridge. Bridge is primarily for browser-based wallets.

Is Bridge safe to run all the time?

Yes — Bridge runs as a local service and listens only for connections from trusted origins. If you prefer, you can start the Bridge service only when needed.

Can I use Bridge with multiple devices?

Yes. Bridge supports connecting multiple Trezor devices, but web clients may only interact with one at a time depending on their UI.

Release & update policy

Trezor publishes periodic updates to Bridge to address compatibility and security. Install auto-updates if you want hassle-free maintenance; otherwise, check the release notes on the official site and update manually as recommended.