Trezor^ Bridge^ — Secure local gateway for your Trezor hardware wallet
Trezor Bridge is the trusted local connector that enables secure communication between your Trezor hardware wallet and applications such as Trezor Suite and compatible web wallets. It provides a consistent, cross-platform API on localhost
, handling USB permissions while ensuring that signing and private key handling remain confined to the hardware device.
Local-firstRuns on your machine and exposes a local API — no external servers required for basic device communication.
Platform supportAvailable across Windows, macOS, and Linux with installer packages and AppImage options.
Safety-firstBridge forwards commands; signing remains on-device and requires your physical confirmation.
Overview — what Bridge does and why it matters
Trezor^ Bridge^ acts as a translator between browser-based or desktop applications and the Trezor device connected over USB. Because browsers and OS environments have differing support for USB access, Bridge provides a stable local endpoint apps can call. This lets web wallets and dApps integrate hardware-wallet signing without exposing sensitive keys to remote services.
- Enables web-based wallet workflows securely.
- Standardizes communication across OS and browsers.
- Ensures signing confirmations remain on your device screen.
Install Bridge — step-by-step
- Download from official site: Always use trezor.io/bridge or the main Downloads page.
- Select your platform: Choose Windows, macOS, or Linux (AppImage or package).
- Verify integrity: When checksums or signatures are provided, verify them before installation to avoid tampered files.
- Run installer & restart apps: Install Bridge, then restart your browser or open Trezor Suite so the app can detect the running Bridge service.
- Connect device: Plug in your Trezor. When prompted, allow access and confirm actions on the device screen.
Note: Desktop Trezor Suite may include native connectivity, but installing Bridge improves compatibility for web-based workflows and varied browser environments.
How to use Bridge with Suite and web wallets
Typical flow when using Suite (web) or a compatible web wallet:
- Open the web wallet or Trezor Suite (Web).
- Ensure Bridge is running on your computer.
- Connect your Trezor device by USB.
- Authorize the connection in the browser if prompted and confirm transaction details on the device screen when signing.
Tips for smooth operation:
- Use the latest browser versions and avoid overly restrictive browser flags that block localhost.
- If a connection fails, try restarting Bridge or switching browsers.
- Test with a small transaction before sending larger amounts.
Troubleshooting — quick fixes
- Bridge not found: Restart the Bridge service or your computer. Check system processes for the Bridge process.
- Browser blocks localhost: Clear cache, restart the browser, or try another browser. Ensure no firewall or security software blocks local ports.
- USB permissions: Reconnect the device, and accept any OS-level USB permission dialogs. On Windows, reinstall USB drivers if needed.
- Multiple versions installed: Uninstall older Bridge versions and reinstall the current release from official Bridge.
- Firmware prompts: If Suite requests firmware updates, follow instructions on Firmware page and install only official releases.
Security best practices
- Install official builds: Use trezor.io/bridge or downloads to avoid impostor installers.
- Keep everything updated: Update Bridge, Suite, browser, and device firmware regularly: Firmware.
- Localhost only: Ensure Bridge listens only on localhost and is not exposed to external networks.
- Beware phishing: Never enter your seed or passphrase on any website — see Anti-Phishing.
- Trust apps carefully: Only grant access to recognized applications and check origins when prompted.