Install Bridge

What is Trezor Bridge?

Trezor Bridge is a lightweight local background service that lets your browser or Trezor Suite communicate with a connected Trezor hardware wallet. It bridges web applications and the USB interface in a more secure, cross-platform way than direct browser USB access.

How it works

🔗
Local service
Runs on your computer and exposes a secure local API for apps (like Trezor Suite or compatible web wallets) to detect and interact with your device.
🛡️
Security model
Only signed requests to the device are allowed; private keys remain on the hardware. Bridge facilitates transport only — all signing happens on-device.

Why use Bridge instead of direct USB?

  • Cross‑platform compatibility with browsers and OSes.
  • Simpler UX: automatic device detection and fewer permission popups.
  • Active maintenance and updates for compatibility and security patches.

Quick install & usage

  1. Download Bridge from the official Trezor site.
  2. Install and allow it to run as a background service.
  3. Open Trezor Suite or a compatible web app. The app will detect your device through Bridge.
Example: check Bridge status
curl http://127.0.0.1:21325/status
(Only for advanced users; avoid running unfamiliar commands.)

Security & best practices

  • Only download Bridge from trezor.io.
  • Keep your OS and Bridge updated to receive security fixes.
  • Close Bridge when not in use if you prefer minimizing background services.
  • Use official Suite or well-audited web apps to avoid phishing or malicious requests.

Troubleshooting

  • If device not detected: restart Bridge service or reconnect the USB cable.
  • Check for conflicting apps that may hold the USB interface (close other wallet software).
  • On macOS, allow the app in Security & Privacy if prompted during installation.