> ## Documentation Index
> Fetch the complete documentation index at: https://trzorio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trezor Device Not Recognized: Fix Detection Issues

> Fix issues where your Trezor device isn't detected by Trezor Suite or your computer. Step-by-step troubleshooting for Windows, macOS, and Linux.

Your Trezor not showing up is one of the most common setup hurdles — and in the vast majority of cases, it comes down to a cable, a port, or a missing driver. Work through the steps below and you'll usually have your device recognized within a few minutes.

## Quick Checks

Before diving into platform-specific fixes, run through these universal checks first. They resolve the issue more often than you'd expect.

* **Try a different USB cable.** Poor-quality or charge-only cables are a leading cause of detection failures. Use the official cable that came with your Trezor whenever possible.
* **Try a different USB port.** Switch to a port directly on your computer rather than a front-panel or peripheral port.
* **Connect directly to the computer.** Unplug any USB hubs, docking stations, or extension cables and plug your Trezor straight into the machine.
* **Close and restart Trezor Suite.** Fully quit the application (don't just close the window) and reopen it after reconnecting your device.
* **Restart your computer.** A full reboot clears driver state and resolves conflicts that a simple app restart won't fix.

## Windows-Specific Fixes

If the quick checks above don't help, Windows may not have the correct driver loaded for your Trezor.

1. Open **Device Manager** (press `Win + X` and select **Device Manager**).
2. Look for any entry listed under **Other devices** or marked with a yellow warning triangle — this often represents your Trezor without a proper driver.
3. Download and install **Trezor Bridge** from [suite.trezor.io/web/bridge](https://suite.trezor.io/web/bridge). Bridge installs the necessary Windows driver and background service.
4. After installation, unplug your Trezor, wait a few seconds, and reconnect it.
5. Refresh Device Manager and confirm the device no longer shows an error.

## macOS Fixes

macOS occasionally blocks the kernel extension (kext) that handles USB communication for hardware devices.

1. Open **System Preferences** (or **System Settings** on macOS Ventura and later) and go to **Security & Privacy** → **General**.
2. If you see a message saying a system extension from Trezor was blocked, click **Allow**.
3. If prompted, restart your Mac to activate the extension.
4. Reconnect your Trezor after the restart and reopen Trezor Suite.

On macOS 13 Ventura or later, USB accessory permissions may require explicit approval in a dialog that appears on the screen — click **Allow** when prompted.

## Linux Fixes

On Linux, your user account needs permission to communicate with USB HID devices. This is granted through **udev rules**.

1. Download the official Trezor udev rules file from the Trezor GitHub repository:

   ```bash theme={null}
   sudo curl https://data.trezor.io/udev/51-trezor.rules -o /etc/udev/rules.d/51-trezor.rules
   ```

   Or with `wget`:

   ```bash theme={null}
   sudo wget https://data.trezor.io/udev/51-trezor.rules -O /etc/udev/rules.d/51-trezor.rules
   ```

2. Reload the udev rules and trigger them:

   ```bash theme={null}
   sudo udevadm control --reload-rules
   sudo udevadm trigger
   ```

3. Add your user to the `plugdev` group (if it exists on your distribution):

   ```bash theme={null}
   sudo usermod -aG plugdev $USER
   ```

4. Log out and back in, then reconnect your Trezor.

## Trezor Bridge

Trezor Bridge is a lightweight background service that lets web-based applications — such as the Trezor Suite web app — communicate with your device over USB. It runs silently in the background and requires no ongoing configuration.

Download the latest version of Trezor Bridge at [suite.trezor.io/web/bridge](https://suite.trezor.io/web/bridge). Once installed, the service starts automatically at login.

<Note>
  Trezor Suite Desktop handles USB communication natively and does **not** require Trezor Bridge. Bridge is only needed when you're accessing your wallet through a browser-based interface.
</Note>

<Tip>
  If none of the steps above resolve the issue, try the web version of Trezor Suite at [suite.trezor.io/web](https://suite.trezor.io/web) as a fallback — it may detect your device even when the desktop app doesn't, and it can help you narrow down whether the problem is with the app or the OS.
</Tip>
