Trezor Bridge — connect your Trezor securely

What Bridge does

Trezor Bridge runs locally and acts as a secure proxy so that authorized applications can talk to your Trezor device without exposing low-level device interfaces directly to the browser. It simplifies user prompts, handles driver compatibility across operating systems, and enables the host app to request actions like device discovery, firmware updates, or transaction signing via the well-documented Trezor Connect protocol.

Install & quick start

Follow these steps to get Bridge running:

1. Download the official Bridge installer for your OS from trezor.io/start.
2. Run the installer and grant necessary permissions. On Windows, administrative rights may be required for driver registration.
3. After installation Bridge runs in the background. Connect your Trezor device via USB and open Trezor Suite or a compatible web app to begin.
4. If the host app still prompts for WebUSB permission, follow the browser prompts and allow the connection.

Security model

Trezor Bridge is intentionally simple and minimal: it does not send your device data to the network. It only facilitates local IPC between the hardware device and the authorized host. Signing operations still occur on the Trezor device itself and require user confirmation on the physical screen. Bridge’s role is only to relay requests; private keys remain on the device and never traverse the Bridge or any network.

Why you might need Bridge

While modern browsers support direct WebUSB, platform differences and permission flows can lead to inconsistent experiences. Bridge improves reliability on older OSes, supports certain browser/driver combinations, and is recommended when the web app suggests installing it. It’s especially useful in enterprise or restricted environments where direct WebUSB may be blocked.

Troubleshooting

If your Trezor isn't detected after installing Bridge, try these steps:

• Ensure the device is connected with a high-quality data USB cable (avoid charge-only cables).
• Restart the Bridge service (on macOS use Activity Monitor, on Windows use Services or Task Manager).
• Try a different USB port or a direct connection (avoid hubs).
• On Windows, verify driver installation and allow administrative permissions when prompted.
• Check for conflicting apps that might claim the USB interface (other wallet apps or USB utilities).

If problems persist, consult the official support center for system-specific instructions and logs you can provide to support staff.

Best practices

• Download Bridge only from trezor.io/start to avoid malicious binaries.
• Keep Bridge updated — installers include security updates and compatibility fixes.
• Use the official Trezor Suite or trusted web apps that use Trezor Connect.
• Never enter your recovery seed into any application or browser — seed entry is only for device recovery flows directly on trusted software or device.
• When sharing logs with support, redact sensitive information and never share your recovery seed or private keys.