What is Trezor Bridge?
Trezor Bridge is a lightweight, local helper application that enables browsers and web-based decentralized applications (dApps) to communicate securely with your Trezor hardware wallet connected by USB. Browsers intentionally restrict direct USB access for safety—Bridge provides a trusted, local channel so dApps can request public keys or signing operations while keeping your private keys on the device.
Why use Bridge?
- Compatibility: Many dApps and wallets rely on Bridge to support a wider set of browsers and OS configurations.
- Security: Bridge only relays requests — the Trezor device displays transaction details and requires on-device confirmation.
- Local control: It runs locally and does not upload your keys or seeds to the cloud.
Safe installation — step-by-step
- Download only from the official site. Go to Trezor's official downloads or support page; avoid links from social media or unknown emails.
- Choose the right installer. Select the package for your OS: Windows, macOS, or Linux.
- Verify integrity (when provided). If a checksum (SHA‑256) or PGP signature is published, compare it with the downloaded file to ensure it wasn't tampered with.
- Run the installer. Follow OS prompts; on macOS you may need to allow the app in Security & Privacy settings.
- Confirm Bridge is running. Look for a tray icon or system service; Bridge listens on localhost and is ready to accept requests from supported browser dApps.
Tip: Keep Bridge updated — installers often contain security and compatibility fixes.
Using Bridge with dApps & wallets
Typical workflow when connecting a dApp to your Trezor:
- The dApp requests a hardware wallet connection in the browser.
- Bridge receives the request on localhost and forwards it to your connected Trezor device.
- The device shows readable transaction details on its screen. Verify the recipient, amounts, and contract data.
- Physically confirm on the Trezor device to sign; Bridge relays the signed data back to the dApp, which broadcasts it to the network.
Always verify every transaction on the device — that's the primary defense against compromised hosts or malicious web pages.
Security & privacy — what to watch for
- Approve only trusted sites. When a website requests Bridge access, allow it only if you trust the origin.
- Never expose Bridge to the internet. Bridge is designed for local use; do not forward its ports or configure remote access.
- Device is the single source of truth. If the address/amount shown on your device differs from the web UI, do not approve the transaction.
- No key storage. Bridge never stores private keys or seeds; those remain on the Trezor.
- Minimal permissions. Grant Bridge access temporarily when needed and close tabs or stop the service when finished for extra caution.
Troubleshooting quick guide
- Bridge not detected: Ensure the service is running (system tray / background services) and restart it if needed.
- Browser can't connect: Try a supported browser, disable blocking extensions, or restart the browser with Bridge running.
- Permission prompts missing: Look for small notifications in the address bar or browser UI; some browsers block localhost calls by default.
- Transport errors: Use the original USB cable, avoid hubs, and ensure Trezor firmware is up to date.