Trezor Bridge

A small, secure background service that lets the Trezor hardware wallet communicate with web applications (via the browser) — required for web-based Trezor Suite and many web integrations.

What is Trezor Bridge?

Trezor Bridge is a lightweight application (runs as a background service) that provides a secure, local communication channel between your Trezor device and web applications. It replaces older browser plugin approaches and is required when using the web version of Trezor Suite or certain third-party web wallets.

Quick: If you're using the desktop Trezor Suite app, Bridge is not required — the desktop client handles communication directly. Bridge is intended for browser/web workflows.

Install & Setup

Visit the official download page (type the manufacturer’s URL manually into your browser to avoid phishing).
Download the Bridge installer for your OS: Windows (.exe), macOS (.dmg), or Linux (.deb / .AppImage).
Run the installer and follow on-screen instructions. You may be prompted for administrative permissions to install the local service.
Once installed, Bridge runs in the background. Connect your Trezor device and open a supported web app — the browser will communicate via Bridge.

After installation, you can check Bridge is running by visiting http://127.0.0.1:21325 (or the local port used) — some Bridge builds expose a local health/status endpoint for diagnostics.

Security & Privacy

Trezor Bridge only listens on your local machine and does not send private keys, recovery seeds, or transaction data off your device. All sensitive actions (PIN entry, seed display, transaction approvals) happen on the Trezor device itself.

Important: Never download Bridge from unofficial sites. Phishing installers can compromise your device and keys. Always verify the domain and prefer the official manufacturer's page.

How to Use (Browser Workflow)

Install Bridge and allow it to run (it may start automatically on login).
Open a supported web app (e.g., web Trezor Suite) in Chrome or Firefox.
Connect your Trezor device via USB and approve the connection on the device screen.
Enter your PIN on the secure on-screen matrix (if required) and continue.

If the site prompts to connect and does not detect your device, ensure Bridge is running and no other app has exclusive access to the USB port.

Troubleshooting

Device not detected: Restart Bridge, switch USB port or cable, avoid USB hubs, and ensure only one app is trying to access the device at a time.
Bridge not running: Check background services (OS task manager), reinstall Bridge, or restart your computer.
Browser can't connect: Clear browser cache, restart the browser, and confirm Bridge version is current. Try another supported browser.
Permissions: macOS may require you to allow the app in Security & Privacy settings; Windows may require administrator permissions to install the service.

# Example: check if Bridge port responds (run in terminal)
curl -sS http://127.0.0.1:21325 || echo "Bridge not reachable"

Compatibility & Versions

Bridge is available for Windows, macOS, and Linux. Keep Bridge updated to ensure compatibility with the latest browser versions and device firmware. When in doubt, use the latest stable Bridge release recommended on the official download page.

FAQ

Do I need Bridge for desktop Trezor Suite?: No — the desktop Suite talks directly to your device. Bridge is required only for some web-based flows.
Is Bridge safe?: Yes, when downloaded from the official source. Bridge is a local service that facilitates communication between your browser and the hardware wallet — all sensitive signing happens on-device.
What if Bridge stops working after an OS update?: Reinstall the latest Bridge version, restart your system, and verify security settings (e.g., macOS privacy permissions).