Installation
Trezor Suite is available on multiple platforms. Choose the installation method that best fits your needs.Desktop
Full-featured offline app for Windows, macOS, and Linux
Web
Browser-based access with no installation required
Mobile
On-the-go portfolio management for iOS and Android
Desktop
The desktop application is built with Electron and offers the most complete Trezor Suite experience with offline capabilities, Tor support, and enhanced privacy features.Download
Download the latest version from the official website.- macOS
- Windows
- Linux
Download the Installer
Download
Trezor-Suite-[version].dmg for your Mac:- Apple Silicon (M1/M2/M3): arm64 version
- Intel Mac: x64 version
Install
- Open the downloaded
.dmgfile - Drag Trezor Suite to the Applications folder
- Eject the disk image
Launch
- Open Finder → Applications
- Right-click Trezor Suite and select Open (first launch only)
- Click Open in the security dialog
On first launch, macOS may show a security warning. This is normal for apps downloaded outside the App Store.
macOS System Requirements
- macOS 10.13 (High Sierra) or later
- 4 GB RAM minimum
- 500 MB free disk space
- USB port or USB-C adapter
Desktop Features
Offline Mode
Use Suite without internet connection for enhanced security
Tor Integration
Built-in Tor support for maximum privacy
Bundled Firmware
Update device firmware without internet connection
Local Data
All data stored locally, never on cloud servers
App ID and Data Directories
Suite uses different data directories based on the environment:| Environment | App ID | App Name | Data Directory |
|---|---|---|---|
| Production | com.trezor.suite | Trezor Suite | @trezor/suite-desktop |
| Development | com.trezor.suite.dev | Trezor Suite Dev | @trezor/suite-desktop-dev |
| Local Dev | com.github.Electron | Trezor Suite Local | @trezor/suite-desktop-local |
Data Directory Locations
Data Directory Locations
macOS:
~/Library/Application Support/[data-directory-name]Windows: C:\Users\[username]\AppData\Roaming\[data-directory-name]Linux: /home/[username]/.config/[data-directory-name]You can access your data directory from Suite’s Debug settings.
Web
Access Trezor Suite directly from your web browser without any installation.Access
Navigate to Suite Web
Open your browser and go to: suite.trezor.io/web
Check Browser Compatibility
Supported browsers:
- Chrome 90+
- Firefox 88+
- Edge 90+
- Brave 1.24+
- Safari 14+ (with limitations)
Connect Your Device
- Click “Connect Trezor”
- Browser will prompt for USB device access
- Select your Trezor device from the list
- Grant permission
Web vs Desktop Comparison
| Feature | Web | Desktop |
|---|---|---|
| Installation | ❌ Not required | ✅ Required |
| Offline Use | ❌ No | ✅ Yes |
| Tor Support | ❌ No | ✅ Yes |
| Firmware Updates | ✅ Yes (online) | ✅ Yes (bundled) |
| Auto-updates | ✅ Always latest | ✅ Yes |
| Platform | Any browser | OS-specific |
Web version requires internet connection and downloads firmware from CDN when needed.
Technical Differences
The web version uses a different architecture:- Connect API: Uses
@trezor/connect-webloaded as a regular JavaScript module - Firmware Binaries: Downloaded from CDN at
[url]/build/static/connect/data/firmware - Communication: Uses WebUSB API (browser permission required)
Mobile
Trezor Suite Mobile is a React Native application available for iOS and Android.- iOS
- Android
Download from App Store
Search for “Trezor Suite” in the Apple App Store or use this link:
Download on App Store
Grant Permissions
The app will request:
- Camera access (for QR code scanning)
- Biometric authentication (optional)
iOS Requirements
- iOS 14.0 or later
- iPhone, iPad, or iPod touch
- 200 MB free space
Mobile Features
Portfolio Tracking
Watch-only mode for monitoring your assets
QR Code Scanner
Easy address scanning for transactions
Biometric Auth
Secure access with fingerprint or Face ID
Notifications
Stay updated on your transactions (coming soon)
Mobile Architecture
The mobile app is built with:- React Native 0.81.5: Cross-platform framework
- Expo SDK 54: Development and build tools
- React Navigation 7: Native navigation
- Redux Toolkit: State management
- Jotai: Atomic state management
Mobile app version: 26.3.1 (as of latest release)
Verification
Verify Desktop Installation
After installing Suite Desktop, verify the installation:Check Version
- Open Suite
- Navigate to Settings → About
- Verify the version number matches your download
Signature Verification (Advanced)
For enhanced security, you can verify the downloaded files:Verify macOS App Signature
Verify macOS App Signature
Authority=Developer ID Application: SatoshiLabsVerify Windows Signature
Verify Windows Signature
- Right-click the installer
- Select Properties → Digital Signatures
- Verify signer: SatoshiLabs s.r.o.
Troubleshooting
Desktop: Application won't launch
Desktop: Application won't launch
macOS: Remove quarantine attribute:Windows: Check antivirus settings and add Suite to exceptionsLinux: Ensure AppImage is executable and run with
--no-sandbox if neededWeb: Device not detected
Web: Device not detected
- Try a different USB cable
- Check browser permissions (chrome://settings/content/usbDevices)
- Restart browser
- Try different browser (Chrome/Brave recommended)
Mobile: USB connection issues
Mobile: USB connection issues
Android:
- Use high-quality USB OTG adapter
- Grant USB permissions when prompted
- Try reconnecting device
- Ensure phone supports USB OTG
All platforms: Slow performance
All platforms: Slow performance
- Close unnecessary applications
- Check available RAM (4GB minimum)
- Clear application cache
- Ensure stable internet connection (for Web)
Next Steps
Quick Start Guide
Learn how to use Trezor Suite
Architecture
Understand how Suite is built