Trezor Bridge — Official Download & Installation Guide

A clear, secure, step-by-step guide to installing and troubleshooting Trezor Bridge on Windows, macOS, and Linux.

What is Trezor Bridge?

Trezor Bridge is a small background service that enables your web browser and the Trezor Suite (or web-based wallet interfaces) to communicate securely with your Trezor hardware device. It facilitates USB connection and message exchange while keeping private keys offline on your device.

Important: Always download Trezor Bridge from the official source — check the official site address in your browser bar before downloading. Never install Bridge from untrusted or third-party pages.

Supported operating systems

Windows: Windows 10, 11 (64-bit recommended)
macOS: macOS 10.15 (Catalina) and newer
Linux: Most major distributions (Deb, RPM, AppImage available)

If you use a corporate or locked-down machine (managed by IT), ask your administrator for installation permissions or use a personal device for setup.

Download Trezor Bridge (official)

Visit the official download page (verify domain) and choose the package that matches your OS. Typical steps:

Open your browser and go to the Trezor official website. Confirm the URL is correct in the address bar.
Locate the Bridge download link or section (often listed as Trezor Bridge).
Select Windows Installer (.exe), macOS Installer (.dmg), or Linux package (.deb/.rpm/AppImage).

Download (from official site)

Note: The button above is a placeholder — always use the link shown on the official website you navigated to (verify the domain).

Install on Windows

Run the downloaded .exe file as Administrator.
Follow the installer prompts. If Windows prompts about an unknown publisher, verify you downloaded from the official site and proceed.
After installation, restart your browser (all windows) to ensure Bridge is recognized.
Open Trezor Suite or the supported web interface and connect your Trezor device using the USB cable. Allow any permission prompts in the browser.

If you previously had an older Bridge version, the installer will update it automatically.

Install on macOS

Open the downloaded .dmg, then drag the Bridge app into the Applications folder if required.
macOS may block installation from unidentified developers — if so, open System Preferences > Security & Privacy and allow the install for the Bridge app.
Restart your browser after installation and connect your Trezor device.

Install on Linux

Choose the package format that fits your distro:

Deb-based (Ubuntu, Debian)

Download the .deb file.
Install via terminal: sudo dpkg -i trezor-bridge-version.deb
Resolve dependencies: sudo apt-get install -f

RPM-based (Fedora)

Download the .rpm file.
Install: sudo dnf install trezor-bridge-version.rpm

You can also use an AppImage where available; make it executable and run it directly.

Verify installation & permissions

Restart your browser and open Trezor Suite or the supported web wallet.
Plug your Trezor device into USB — the site/app should detect it. You may be asked to allow the connection; confirm only for trusted pages.
On Windows, check Services for Trezor Bridge. On macOS/Linux, confirm the Bridge process is running via ps or Activity Monitor.

Troubleshooting common issues

Device not detected: Try another USB port, use the original cable, restart browser/PC, or reinstall Bridge.
Browser shows connection error: Fully close all browser windows and re-open. Ensure no other app is blocking USB access.
Permission blocked by OS: On macOS allow the app in Security & Privacy. On Linux ensure you have correct udev rules (some distros require adding a udev rule for Trezor).
Bridge version mismatch: Re-download the latest Bridge installer from the official site and reinstall.

If problems persist, consult official documentation or community support channels, and report exact error messages to speed up help.

Security best practices

Only download Bridge from the official Trezor website — verify the domain and certificate.
Never enter your recovery seed or private keys into any website or software.
Keep your device firmware and Bridge up to date.
Avoid using public or unmanaged computers for sensitive setup steps.