Trezor Bridge — Quick Guide

What is Trezor Bridge?

Trezor Bridge is a small local application that allows your browser or desktop Suite to communicate with a Trezor hardware wallet over USB. It replaces older browser plugin methods and provides a secure bridge between the device and web apps like Suite.

Quick install

1. Download Bridge from the official Trezor website. Always verify you are on the official domain.
2. Run the installer for your OS (Windows / macOS / Linux) and follow the prompts.
3. After install, Bridge runs in the background and opens a local web endpoint (usually at http://127.0.0.1:21325 or similar).
4. Plug in your Trezor device and open Trezor Suite or the web app; the app should detect the device automatically.

Install notes by platform

• Windows: Run the .exe installer. If the device isn't recognized, try reinstalling Bridge and using a different USB cable/port. On older Windows, you may need a driver reinstall.
• macOS: Allow the installer in System Preferences → Security & Privacy if macOS blocks it. After install, Bridge runs as a background app (menu bar icon).
• Linux: Use the .deb/.rpm packages where available. For manual installs, run Bridge as a daemon. Ensure your user has appropriate USB permissions (uaccess/udev rules).

How to verify Bridge is running

• Open your browser and visit http://127.0.0.1:21325 — Bridge often responds with a simple JSON welcome message (if accessible).
• Check for a Bridge icon in the system tray / menu bar.
• In Trezor Suite, try reconnecting the device: Settings → Help → Reconnect device.

Troubleshooting

• Device not detected: Try a different USB cable, USB port, or a powered USB hub. Avoid USB hubs known to block data (some are power-only).
• Bridge not running: Restart Bridge (find it in system tray / Activity Monitor / Task Manager) or reinstall it.
• Browser blocking: Clear site data or allow the web app to access local resources. If using the web app, enable WebUSB when applicable or use the desktop Suite instead.
• Permission issues (Linux): Ensure udev rules are installed; add your user to the appropriate groups or run Bridge with proper permissions.
• Multiple apps conflict: Close other wallet apps that might be accessing the Trezor (only one app should talk to the device at a time).

Security & privacy

• Bridge runs locally on your machine and does not transmit your keys or seed to the internet.
• Always download Bridge from the official Trezor website and verify signatures when available.
• Bridge opens a local port; only local processes should connect to it. If you suspect unexpected activity, stop Bridge and investigate running processes/connections.

Uninstalling Bridge

• Windows: Use Add/Remove Programs to uninstall Trezor Bridge.
• macOS: Run the uninstaller included with the package or remove Bridge from Applications and delete support files in ~/Library.
• Linux: Remove the package with your package manager or stop & remove the Bridge daemon.

Quick commands & checks

• Visit: http://127.0.0.1:21325
• Check tray/menu bar for Bridge icon
• Restart Bridge or your browser if device isn't detected