Quick installation
- Download the installer for your OS from the official source.
- Run the installer and follow on-screen prompts. Reboot if requested.
- Open a supported browser and visit a compatible web wallet (e.g., Trezor Suite or a web dapp).
- When prompted, allow the site to detect your device. If not detected, confirm Bridge is running.
Command-line (Linux example)
# Example: run AppImage chmod +x trezor-bridge.AppImage ./trezor-bridge.AppImage # or install with APT (example) sudo dpkg -i trezor-bridge.deb sudo apt-get -f install
Troubleshooting & FAQ
Q: My browser doesn't detect Trezor. What do I do?
A: Ensure Bridge is running (check system tray / menu bar), try reconnecting the device, and confirm the browser isn't blocking local connections.
A: Ensure Bridge is running (check system tray / menu bar), try reconnecting the device, and confirm the browser isn't blocking local connections.
Q: Is Bridge safe to run?
A: Yes — Bridge only accepts local connections and does not expose your keys. Always download from the official site.
A: Yes — Bridge only accepts local connections and does not expose your keys. Always download from the official site.
Q: Can I use Bridge with headless systems?
A: A CLI mode or package-specific integration may be available for headless setups; check the official docs for your distribution.
A: A CLI mode or package-specific integration may be available for headless setups; check the official docs for your distribution.
Developer notes
If you build integrations that talk to Trezor devices via Bridge, follow principles: ask for least privileges, validate origins, and never log sensitive data. Consider using the official protocol library and verify USB messages on-device.