Introduction
Trezor Bridge is the small desktop helper application that lets your browser communicate securely with a Trezor hardware wallet. It replaces the older WebUSB browser integration and creates a stable, cross-platform connection between wallet.trezor.io (or compatible apps) and your device. This guide explains what Bridge does, how to install it, and how to solve common issues so you can connect your Trezor with confidence.
Installing Trezor Bridge
Supported platforms
Bridge supports Windows, macOS and many Linux distributions. For most users, the official installer from Trezor is the simplest option — it auto-installs the service and registers required native protocols so that modern browsers can find your device.
Steps to install
- Download the installer from the official Trezor site.
- Run the installer and follow prompts (admin/root rights may be required).
- Restart your browser and plug in the Trezor device.
Permissions
On Windows you may need to accept a driver prompt. macOS may ask to approve a system extension. Linux users might need to add udev rules (instructions are in the official docs).
Using Bridge with wallet.trezor.io
Once installed, open wallet.trezor.io (or the web app you use). Bridge runs in the background and acts as a local proxy — when the site needs to access your device it negotiates a secure channel via Bridge. Confirm device prompts on the Trezor screen and never share your recovery seed with the web app.
Best practices
- Always keep Bridge updated to the latest version.
- Use official download links only.
- Disconnect when not in use and keep firmware current.
Troubleshooting common issues
Browser won't detect device
Restart the browser, replug the USB cable, and confirm Bridge is running (check system tray or background services). Try a different USB port and avoid USB hubs when possible.
Driver or permission errors
On Windows, reinstall Bridge as administrator. On Linux, ensure udev rules are present and your user is in the right groups. On macOS, allow system extensions in Security & Privacy if prompted.
Logs & support
Bridge logs can help diagnose persistent problems — consult the official support pages and community resources when necessary.
Security considerations
Bridge itself is a local-only service; it does not transmit your recovery seed. Use only official releases, verify signatures where provided, and keep both Bridge and your Trezor firmware updated. Treat firmware updates with care: only apply updates when they originate from the official ecosystem.
What never to do
- Never enter your seed into a website or copy it into a file.
- Do not install Bridge from untrusted mirrors.
Official resources
Below are ten official links to Trezor resources and related pages for installers, support, and developer tools.