What is Trezor Bridge?
Trezor Bridge is a small local program (service) that runs on your computer and provides a secure communication channel between a Trezor hardware wallet and web browsers or desktop applications. It acts as an intermediary so that websites or apps that support Trezor can talk to the device over USB without exposing private keys — the keys always remain on the hardware wallet.
How it works
- Local service: Bridge runs locally (on 127.0.0.1) and listens for requests from supported apps.
- Device detection: When you plug in your Trezor, Bridge detects it and forwards secure commands.
- No key storage: Private keys never leave the device — Bridge only passes messages.
- Permissions: Some OSes (macOS) may require you to allow Bridge in Security & Privacy after installation.
Installation (Windows / macOS / Linux)
Download the official installer for your OS from the link above. Quick steps for each OS are below — use the official page for the latest package.
Windows
- Download the
.exefrom the official site. - Run the installer and follow on‑screen prompts.
- Restart your browser and open Trezor Suite or the supported web app.
macOS
- Download the
.pkginstaller. - Open it and follow the macOS installer flow.
- If blocked, go to System Preferences → Security & Privacy and click "Allow" for the Bridge installer.
Linux
- Download the
.debor.rpmdepending on your distro. - Install with your package manager (e.g.
sudo dpkg -i trezor-bridge-*.deb). - Restart your browser or Trezor Suite.
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| Trezor not detected | Bridge service not running | Check OS service list, restart Bridge, reconnect device |
| Browser shows "Looking for Trezor" | Outdated Bridge or cached page | Reinstall Bridge, clear browser cache, restart browser |
| Device appears but actions fail | Old browser extension or conflicting driver | Remove old Trezor extensions; try a different USB cable/port |
| macOS installer blocked | Gatekeeper restrictions | Open Security & Privacy and allow the installer |
| Access denied on Linux | Missing udev rules / permissions | Install udev rules from Trezor docs or run with proper permissions |
Official resources
- Trezor Bridge — official download
- Trezor Suite (desktop & web)
- Trezor Support Center
- Trezor Wiki / Manuals
- Trezor Blog / Security Notices
Top 5 FAQs
1. Do I need Bridge if I use Trezor Suite Desktop?
No — the Trezor Suite desktop app includes the necessary bridge functionality. Installing Bridge is only required for using Trezor from within a web browser (Trezor Suite Web or other supported pages).
2. Is Trezor Bridge safe?
Yes. Bridge is developed by SatoshiLabs and runs locally. Always download Bridge from the official Trezor site to avoid tampered installers.
3. Which browsers are supported?
Most modern browsers (Chrome, Edge, Firefox, Brave) are supported. Safari has limited USB access and may not work reliably.
4. How do I check if Bridge is running?
Visit https://127.0.0.1:21325/status/ in your browser (Bridge listens on that local address) — a running Bridge responds with status information. Alternatively, check your system tray or process list for the Bridge service.
5. Can I install Bridge on multiple computers?
Yes. Bridge can be installed on any computer you control; each machine runs its own local Bridge service and can talk to any Trezor device plugged into it.
Quick copy snippets
Useful commands and links you can copy:
https://trezor.io/bridge/ Trezor Suite: https://suite.trezor.io/ Check status: https://127.0.0.1:21325/status/