Skip to main content

​
Device management

Trezor Suite provides comprehensive device management capabilities, allowing you to connect, manage, and switch between multiple Trezor devices seamlessly.

​
Connecting devices

​
First-time connection

When connecting a Trezor device for the first time:
1

Connect device

Plug your Trezor device into your computer using the USB cable.
2

Device detection

Suite automatically detects the device and displays it in the interface.
3

Unlock device

Enter your PIN on the device when prompted. The PIN layout is displayed in Suite but entered on the device.
4

Device ready

Once unlocked, your device is ready to use. Suite begins account discovery automatically.
Suite uses WebUSB (web) or native USB communication (desktop) to connect to your device. No additional drivers are required on most systems.

​
Device states

Your Trezor device can be in several states:
  • Device is plugged in and detected
  • Shows in device dropdown
  • Ready for authentication
// Device state types
type DeviceStatus = 
  | 'available'      // Connected but not acquired
  | 'occupied'       // Used by another application
  | 'used'           // Acquired by Suite
  | 'released';      // Released from Suite

type DeviceMode =
  | 'normal'         // Standard operation
  | 'bootloader'     // Firmware update mode
  | 'initialize'     // Needs setup
  | 'seedless';      // No seed loaded

​
Device selection

When multiple devices are connected, Suite allows you to switch between them.

​
Switching devices

1

Open device menu

Click the device name in the top-left corner of Suite.
2

Select device

Choose the device you want to use from the dropdown list.
3

Authenticate

Enter the PIN for the selected device.
4

Access accounts

Suite loads the accounts for the selected device.
Each device is identified by its device ID, which is derived from its internal configuration and firmware.

​
Device identification

Suite identifies devices using:
  • Device ID: Unique identifier based on device internals
  • Device label: Custom name you set in device settings
  • Model: Trezor One, Trezor Model T, Trezor Safe 3, etc.
  • Firmware version: Current firmware installed

​
Multiple device support

Suite can manage multiple Trezor devices simultaneously.

​
Use cases

Use different devices for different purposes:
  • One for daily transactions
  • One for long-term savings
  • One for business funds
Developers can:
  • Test with multiple device configurations
  • Compare different firmware versions
  • Verify cross-device compatibility
Manage devices for:
  • Family members
  • Business partners
  • Separate entities

​
Device memory

Suite remembers recently used devices:
  • Device list persists across sessions
  • Each device stores its own wallet instances
  • Settings are per-device when applicable
  • Account discovery state is cached
// Device storage structure
interface RememberedDevice {
  id: string;                    // Device ID
  label?: string;                // Custom label
  state: string;                 // Device state
  staticSessionId?: string;      // Session identifier
  remember: boolean;             // Persist device memory
  connected: boolean;            // Currently connected
  available: boolean;            // Available for use
  features: {
    vendor: string;
    model: string;
    firmware_version: [number, number, number];
    // ... more features
  };
}

​
Ejecting devices

Properly ejecting a device clears its session and memory from Suite.

​
Manual eject

1

Open settings

Navigate to Settings → Device.
2

Eject device

Click Eject device or use the eject icon in the device dropdown.
3

Confirm action

Suite clears the device session and removes it from the active device list.
4

Physical disconnect

You can now safely unplug the device.
Ejecting a device doesn’t delete any data. When you reconnect, you can access all wallets and accounts again.

​
Auto-eject feature

Suite can automatically eject devices when appropriate. Enable auto-eject:
  1. Go to Settings → Application
  2. Enable Auto-eject device
  3. Device will be ejected when:
    • Discovery completes
    • Switching to another device
    • Suite closes (desktop)
Auto-eject is useful for enhanced security when using multiple devices or shared computers.

​
Device sessions

Sessions manage the state between Suite and your device.

​
Session lifecycle

1

Acquire session

Suite requests exclusive access to the device.
2

Initialize device

Device features are fetched and validated.
3

Create state

Device state is created after PIN entry and optional passphrase.
4

Active session

Full access to device features and accounts.
5

Release session

Session ends when device is ejected or disconnected.

​
Static session IDs

Suite uses static session IDs for device state management: 
interface DeviceState {
  staticSessionId: string;  // Persistent identifier
  state: string;            // Current state hash
}

// Static session ID format: "stateHash:instanceNumber"
// Example: "d4f5e6a7b8c9:0"
Static session IDs allow Suite to track different wallet instances (passphrases) for the same physical device.

​
Device compatibility

​
Supported devices

  • Display: 128×64 OLED
  • Buttons: 2 physical buttons
  • Connection: USB-A
  • Features: All core features

​
Firmware requirements

Some Suite features require minimum firmware versions:
  • Basic features: Any firmware version
  • Passphrase on device: T1: 1.9.0+, TT: 2.3.0+
  • Cardano: T1: Not supported, TT: 2.3.2+
  • CoinJoin: T1: 1.10.0+, TT: 2.4.0+
  • Solana: T1: Not supported, TT: 2.4.3+
Using outdated firmware may limit available features or cause compatibility issues. Keep your firmware updated.

​
Troubleshooting

Windows:
  • Install Trezor Bridge (desktop) or use web version
  • Check USB cable and port
  • Try different USB port
macOS:
  • Grant USB permissions in System Preferences
  • Try different USB port
  • Restart Suite
Linux:
  • Install udev rules
  • Check user permissions
  • Verify USB access
Cause: Another application is using the deviceSolution:
  • Close other crypto applications
  • Close duplicate Suite tabs/windows
  • Disconnect and reconnect device
  • Restart Suite
Cause: Multiple devices or cached stateSolution:
  • Use device selector to choose correct device
  • Eject other devices
  • Clear application data (Settings → Application)
Causes:
  • Loose USB connection
  • Power-saving mode
  • USB hub issues
Solutions:
  • Use direct connection (not USB hub)
  • Disable USB power saving
  • Try different cable

​
Security considerations

​
Physical security

Never leave your device unattended while unlocked
Use the eject feature when done with a session
Enable auto-eject for shared computers
Store devices in secure locations when not in use

​
Session management

Active sessions grant full access to your wallets. Always eject devices when:
  • Leaving your computer
  • Sharing your computer
  • Finished using Suite

​
Device authentication

Verify device authenticity:
  1. Check the device arrives sealed
  2. Verify the packaging
  3. Use firmware verification in Suite
  4. Check firmware signatures
See Firmware updates for authentication details.

​
Advanced features

​
Device fingerprint

Unique device fingerprint based on: 
interface DeviceFingerprint {
  model: string;
  deviceId: string;
  firmware: [number, number, number];
  bootloaderHash: string;
  vendorHeader: string;
}

​
Bootloader mode

Accessing bootloader for firmware updates:
  1. Disconnect device
  2. Hold both buttons (Model One) or touch screen (Model T)
  3. Connect device while holding
  4. Device enters bootloader mode
  5. Ready for firmware installation
Bootloader mode is required for firmware updates. See Firmware updates for complete instructions.

Firmware updates

Update your device firmware

Device settings

Configure device-specific settings

Backup and recovery

Backup and recover your device

Security

Device security best practices

Build docs developers (and LLMs) love

Get started for freeTalk to us