Skip to content

Latest commit

 

History

History
48 lines (31 loc) · 2.62 KB

WasabiCompatibility.md

File metadata and controls

48 lines (31 loc) · 2.62 KB

Abstract

This document lists all the officially supported software and devices by Wasabi Wallet. This means that Wasabi is tested on those systems, and we put all the efforts to make it work and maintain compatibility. One of our main goals is to not break the user-space, so we have to set up boundaries that we can responsibly maintain. This does not necessarily mean that systems that are not listed will not work - they might work, but we do not officially support them. There are a lot of potentially supported systems out there and more to come, but we can only promise support and stability on platforms that our dependencies support, too.

Officially Supported Operating Systems

  • Windows 10 1607+
  • Windows 11 23H2+
  • macOS 14+
  • Ubuntu 22.04+
  • Fedora 42+
  • Debian 12+

Officially Supported Hardware Wallets

  • Trezor: Model T, Safe 3, Safe 5
  • ColdCard: MK1, MK2, MK3, MK4, Q
  • Ledger: Nano S, Nano S Plus, Nano X
  • Blockstream: Jade
  • BitBox: BitBox02-BtcOnly, BitBox02 Nova1*

1* The device by default asks for a "Pairing code", currently, there is no such function in Wasabi. Therefore, either disable the feature or unlock the device with BitBoxApp or hwi-qt before using it with Wasabi.

Officially Supported Architectures

  • x64 (Windows, Linux, macOS)
  • arm64 (macOS, Linux (experimental))

FAQ

What is required to run Wasabi Wallet on officially supported Operating Systems?

Wasabi dependencies are:

What are the bottlenecks of officially supporting Hardware Wallets?

Wasabi dependencies are:

  • HWI, check the device support list there. Some hardware wallets supported by HWI are still not compatible with Wasabi Wallet because they implemented custom workflows.

What about Tails and Whonix?

Tails and Whonix are privacy-oriented OSs, so it makes sense to use them with Wasabi Wallet. At the moment, Wasabi is working properly on these platforms, but our dependencies do not officially support them, so we cannot make promises regarding future stability.

Wasabi automatically detects if it is running on Tails or Whonix and will use the already running system-wide Tor instance, instead of starting its own.

On Wasabi version 2.7.2 and earlier, Wasabi should be started with the following startup parameter: --UseTor=EnabledOnlyRunning.