OFFICIAL BRIDGE

Secure Connection for Your Trezor Device

Trezor Bridge is a communication tool that facilitates the interaction between your Trezor hardware wallet and your browser. Download and install to unlock the full potential of your device.

What is Trezor Bridge?

Trezor Bridge is a lightweight application that enables communication between your Trezor hardware wallet and supported web browsers. It acts as a secure intermediary, allowing web applications like Trezor Suite to interact with your device without compromising security.

Unlike browser extensions that can be vulnerable to attacks, Trezor Bridge runs as a standalone program on your computer, providing an additional layer of security for your cryptocurrency transactions.

Enhanced Security

Runs independently from your browser, eliminating extension-based vulnerabilities.

Universal Compatibility

Works seamlessly with all major browsers and operating systems.

Automatic Updates

Stays up-to-date with the latest security patches and features.

Lightweight

Minimal system resources required, runs efficiently in the background.

How Trezor Bridge Works

Understanding the communication flow between your browser, Trezor Bridge, and your hardware wallet is essential for appreciating the security model.

1

Browser Request

When you access Trezor Suite or another compatible web application, the browser attempts to communicate with your Trezor device.

2

Bridge Intercepts

Trezor Bridge running on your system intercepts this request and establishes a secure connection with your hardware wallet via USB.

3

Secure Communication

All data is encrypted and transmitted through Bridge, ensuring that sensitive information never passes directly through the browser.

4

Device Confirmation

Your Trezor device displays transaction details on its screen, requiring physical confirmation before any action is executed.

Security Note

Trezor Bridge never stores your private keys or sensitive data. It simply facilitates communication, with all cryptographic operations happening securely on your Trezor device.

Download Trezor Bridge

Choose the appropriate version for your operating system. Trezor Bridge is compatible with Windows, macOS, and Linux distributions.

Windows

Version 2.0.33

macOS

Version 2.0.33

Linux

Version 2.0.33

System Requirements

  • Windows: Windows 7 or newer (64-bit)
  • macOS: macOS 10.13 (High Sierra) or newer
  • Linux: Ubuntu 18.04+, Debian 10+, Fedora 30+, or equivalent
  • Browser: Chrome 59+, Firefox 54+, Edge 79+, or Opera 46+

Installation Guide

Follow these step-by-step instructions to install Trezor Bridge on your system.

Windows Installation

  1. 1Download the trezor-bridge-2.0.33-win32-install.exe file from the download section above.
  2. 2Double-click the downloaded file to launch the installer.
  3. 3Follow the installation wizard. You may need to grant administrator permissions.
  4. 4Once installed, Trezor Bridge will start automatically and run in the background.
  5. 5Connect your Trezor device and refresh your browser to verify the installation.

macOS Installation

  1. 1Download the trezor-bridge-2.0.33.dmg file.
  2. 2Open the .dmg file and drag the Trezor Bridge icon to your Applications folder.
  3. 3Launch Trezor Bridge from your Applications folder. You may need to allow the app in System Preferences → Security & Privacy.
  4. 4The application will run in the menu bar. Look for the Trezor icon to confirm it's running.
  5. 5Connect your Trezor device and refresh your browser.

Linux Installation

  1. 1Download the appropriate package for your distribution (.deb for Debian/Ubuntu or .rpm for Fedora/Red Hat).
  2. 2
    For Debian/Ubuntu, run:sudo dpkg -i trezor-bridge_2.0.33_amd64.deb
  3. 3
    For Fedora/Red Hat, run:sudo rpm -i trezor-bridge-2.0.33.x86_64.rpm
  4. 4The service will start automatically. You can verify it's running with systemctl status trezord.service
  5. 5Connect your Trezor device and configure udev rules if necessary (usually handled automatically).

Documentation

Comprehensive technical documentation for developers and advanced users.

API Endpoints

Trezor Bridge exposes a local HTTP API running on port 21325. This API allows web applications to communicate with connected Trezor devices.

http://localhost:21325/

Checking Bridge Status

You can verify that Trezor Bridge is running by making a GET request to the status endpoint:

GET http://localhost:21325/status
Response:
{ "version": "2.0.33" }

Device Enumeration

List all connected Trezor devices:

GET http://localhost:21325/enumerate

Security Considerations

  • All communication with Bridge happens over localhost (127.0.0.1)
  • CORS is properly configured to prevent unauthorized access
  • The API only accepts requests from authorized origins
  • Private keys never leave the Trezor device

Troubleshooting

Common issues and their solutions.

Bridge not detected by browser

Ensure Trezor Bridge is running. Check your system tray (Windows/Linux) or menu bar (macOS) for the Trezor icon. If it's not running, launch it from your Applications folder. Then, refresh your browser page.

Device not recognized after connecting

Try unplugging and reconnecting your Trezor device. Make sure you're using a data-capable USB cable (not just a charging cable). On Linux, verify that udev rules are properly configured.

Port 21325 already in use

Another application or an old instance of Bridge may be using the port. Restart your computer or manually kill the process using port 21325. On Linux/macOS, use: sudo lsof -i :21325 to identify the process.

macOS: "Bridge cannot be opened because it is from an unidentified developer"

Go to System Preferences → Security & Privacy → General. Click "Open Anyway" next to the message about Trezor Bridge. You may need to enter your password.

Linux: Permission denied when connecting device

Install the udev rules: wget -O /tmp/51-trezor.rules https://data.trezor.io/udev/51-trezor.rules && sudo mv /tmp/51-trezor.rules /etc/udev/rules.d/ && sudo udevadm control --reload-rules

Bridge version outdated

Download and install the latest version from this page. Bridge should automatically update, but manual updates may be required in some cases.

Support & Resources

Need additional help? Here are ways to get support and learn more.

Knowledge Base

Browse our comprehensive guides and tutorials

Community Forum

Connect with other Trezor users and experts

GitHub Repository

View source code and report technical issues

Contact Support

Reach out to our support team directly

Frequently Asked Questions

Do I need Trezor Bridge to use my Trezor device?
Yes, for web-based applications like Trezor Suite. However, the Trezor Suite desktop application has Bridge built-in and doesn't require a separate installation.
Is Trezor Bridge safe to install?
Yes, Trezor Bridge is open-source software developed and maintained by SatoshiLabs. It has been audited and is widely used by the cryptocurrency community. Always download from official sources.
Can I use multiple Trezor devices with Bridge?
Yes, Trezor Bridge supports multiple devices connected simultaneously. You can switch between them in your web application.
Does Bridge work with third-party wallets?
Yes, many third-party cryptocurrency wallets and applications support Trezor through Bridge, including MyEtherWallet, Electrum, and others.
How do I update Trezor Bridge?
Bridge should update automatically when a new version is available. You can also manually download and install the latest version from this page.
Will Bridge slow down my computer?
No, Trezor Bridge is very lightweight and uses minimal system resources. It runs in the background and only activates when needed.
Can I uninstall Bridge if I don't need it anymore?
Yes, you can uninstall Trezor Bridge like any other application through your operating system's control panel or applications manager.
Does Bridge store my private keys or passwords?
No, Bridge never stores or accesses your private keys, passwords, or any sensitive information. It only facilitates communication between your browser and device.