# Installation of Wasabi

# Installing the Package

Where can I download Wasabi?

You can find the recent version of the compiled packages for Linux, Windows and Mac available on the official wasabiwallet.io. It's always best to download software directly from the official source acknowledged by the developers. In order to preserve your network level privacy from the very first step on, please consider visiting the Tor onion service wasabiukrxmkdgve5kynjztuovbg43uxcbcxn6y2okcrsg7gb6jdmbad.onion. The old versions of the software can be found in the releases of the GitHub repository, here you also find the libre & open source code for when you want to build it yourself. Please take special care to verify the PGP signatures of zkSNACKs' PGP public key 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E over the software packages and code commits.

Why is it important to verify PGP signatures?

WARNING

Don't trust ~ verify.

These are not just empty words. Self sovereignty is at the core of Bitcoin in general, and Wasabi specifically. You have powerful tools at your disposal, yet they only work when used as they are designed. Wasabi is tailor made so that you do not have to trust anyone, but you have the power to verify everything.

With PGP signatures you can verify that the software package you download is actually the one by the developers. Every release of Wasabi is signed by zkSNACKs, the company behind Wasabi. You can verify that the PGP public key 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E is actually the one of zkSNACKs by exploring the web of trust. When you have a software package that was signed by this PGP public key, then you can be sure that this is an official release approved by zkSNACKs. This protects you against malicious man in the middle attacks where bad guys give you a fake version of Wasabi with malicious code.

How can I verify PGP signatures?

On the WasabiWallet.io website you can download the packages of the latest release. Ensure that you also download the separate signature .asc file. In the terminal, change the directory to the one with the downloaded files, and verify the signature with gpg --verify Wasabi-1.1.12.1.deb.asc. Everything is valid if it returns Good signature from zkSNACKs and that it was signed with the Primary key fingerprint: 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E.

For an in-depth guide for Debian and Ubuntu, other Linux, Windows, and macOS see the main documentation.

How do I install Wasabi on Debian and Ubuntu?

Download the most recent .deb package and the .deb.asc signature file from the wasabiwallet.io or the Tor onion service.

Download Wasabi Wallet for Debian

Verify the signature of the package with gpg --verify Wasabi-1.1.12.1.deb and ensure the software was signed by zkSNACKs' PGP public key 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E.

Now install Wasabi with sudo dpkg -i Wasabi-1.1.12.1.deb, and run it with wassabee. Check out the main documentation for a step-by-step guide.

How do I install Wasabi on other Linux?

Download the most recent .tar.gz package and the .tar.gz.asc signature file from the wasabiwallet.io or the Tor onion service.

Download Wasabi Wallet for Linux

Verify the signature of the package with gpg --verify Wasabi-1.1.12.1.tar.gz.asc and ensure the software was signed by zkSNACKs' PGP public key 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E. Now install Wasabi with sudo tar -pxzf Wasabi-1.1.12.1.tar.gz, and run it with ./wassabee. Check out the main documentation for a step-by-step guide.

How do I install Wasabi on Windows?

Download the most recent .msi package and the .msi.asc signature file from the wasabiwallet.io or the Tor onion service.

Download Wasabi Wallet for Windows

The Wasabi package is signed and automatically verified on Windows upon installation.

Wasabi Wallet Windows signature verification

Optionally, you can still verify the PGP signature of the package by right-clicking on the signature file > More GpgEX options > Verify and ensure the software was signed by zkSNACKs' PGP public key 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E. Now install Wasabi by double-clicking the .msi file. Check out the main documentation for a step-by-step guide.

How do I install Wasabi on macOS?

Download the most recent .dmg package and the .dmg.asc signature file from the wasabiwallet.io or the Tor onion service.

Download Wasabi Wallet for macOS

The Wasabi package is signed and automatically verified on macOS upon installation.

Optionally, you can still verify the PGP signature of the package with sudo gpg2 --verify Wasabi-1.1.12.1.dmg.asc and ensure that the software has been signed by zkSNACKs' PGP public key 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E. Now install Wasabi by double-clicking the .dmg file. Check out the main documentation for a step-by-step guide.

How do I check the current version of Wasabi?

In the GUI, go to the top left menu Help > About, here you will be able to see the current version of your Wasabi. You can also verify the version using the command line by executing wassabee --version or wassabeed --version if you are on Windows. Wasabi is cutting edge software, so it is well-advised to stay up-to-date.

How do I know about a new version of Wasabi?

When a new major version [v1.1.X] has been released, you'll see a notification in the bottom left status bar New Version Available. There are occasional silent releases like [v1.1.10.X] which fix issues that were introduced in a major release, and these are not announced in the GUI. The website always links to the most recent build of the software. It will also be announced on Twitter and Reddit.

How do I securely upgrade Wasabi?

You can download the software build for the different operating systems on the main website or better over Tor. Make sure you also download the signatures of the build and verify them with zkSNACKs' PGP public key. For step-by-step instructions, follow this guide or see this video.

Do I need to install Tor separately?

No, because Wasabi has Tor built into the software. All Wasabi network traffic goes via Tor by default - no need to set up Tor yourself. If you do already have Tor, and it is running, then Wasabi will try to use that first.

You can turn off Tor in the Settings. Be careful, as this will compromise your privacy. When you CoinJoin over clearnet, the coordinator would know the links between your inputs and outputs based on your IP address. When you broadcast a transaction over clearnet, the connected full node will know the link between your transaction and your IP address.

Can I install Wasabi on TAILS?

Yes, just follow the Wasabi Setup on Tails guide and remember to save/back up the wallet on the Persistence.

What are the differences between the Debian/Ubuntu version and the "Other Linux" version?

Debian/Ubuntu version contains .deb package. Other Linux version contains .tar.gz package.

The advantages of the .deb format is solely packaging related. It installs Wasabi in your computer, so you're able to access it from start menu, remove it through apt, and so on.

The "Other Linux" option is just a generic install method not targeted to Debian/Ubuntu specifically but that works on it anyway because it is still linux.

There's no difference in the code, the same binaries are being delivered in different formats.

# Advanced Installation

How do I compile Wasabi from source?

If you cannot wait until the next release, and you want to experience the most cutting-edge version of Wasabi, then you can build the source code.

The only two required tools are Git and .NET Core 3.1 SDK for "Building Apps". You can download every line of the Wasabi code by git clone https://github.com/zkSNACKs/WalletWasabi.git, this will create a new directory called WalletWasabi. In order to build and run the Wallet software, change directory to cd WalletWasabi/WalletWasabi.Gui. Wasabi is written in C# with the .NET framework, and it is very easy to run it. Simply execute dotnet run from the WalletWasabi.Gui folder. You can update the master branch with git pull.

How can I verify the deterministic build?

The guide for the deterministic builds can be found in the WalletWasabi repository.

My antivirus marks Wasabi Wallet as a virus. Am I downloading the right software?

After you have downloaded Wasabi from the official website or from the official GitHub repository, make sure you have verified the PGP signatures.

If you have downloaded and verified digital signatures and your antivirus continues to report Wasabi as positive, you don't have to worry about anything; it is a false positive.

If you are still not sure, before starting Wasabi, you can check that it is safe by uploading and scan it via VirusTotal.

TIP

Remember to report Wasabi as a safe software/false positive to your antivirus. In doing so you will help users who use the same antivirus.

::::

Why is the executable called wassabee?

The most obvious thing would be to call the executable Wasabi Wallet.exe on Windows and Wasabi Wallet on Linux and Mac.

However launching Wasabi Wallet from certain terminals/command lines is problematic, so we should remove the spacing: WasabiWallet, and the case sensitivity differences between the operating systems can also cause issues, so that must go too: wasabiwallet.

But it's too long, it needs a faster way to launch: wasabi.

However this is too generic, it'll certainly cause conflicts, we need to make it unique: wassabee.

Also, this sounds awesome and is a fun inside joke.