Install package
A step by step guide on how to securely download, verify and install the software packages of Wasabi for Linux, Windows and Mac. This is the Wasabi documentation, an archive of knowledge about the ope
[[toc]]
Introduction
The easiest way to start with Wasabi is to download, verify and install the released package. This is a version of the software that is thoroughly reviewed by the contributors. The package has the binary code that is needed to run the Wasabi Wallet client including the graphical user interface. For compiling the open-source code with cutting edge development features, also including the backend server, see this tutorial here.
Download the packages either from the official WasabiWallet.io clearnet website or for your privacy's sake, from the official Tor onion service http://wasabiukrxmkdgve5kynjztuovbg43uxcbcxn6y2okcrsg7gb6jdmbad.onion.
Although there is automatic signature verification on Windows and macOS, it is still recommended to manually VERIFY PGP SIGNATURES of the downloaded package with zkSNACKs' PGP public key ${zksnacksPublicKeyFingerprint} before installing Wasabi. This protects you against malicious phishing sites giving you back-doored wallet software. If you have personally verified zkSNACKs' PGP public key ${zksnacksPublicKeyFingerprint} and you are familiar with the Web Of Trust, please consider also signing it.
:::tip Always Don't trust - Verify! :::
Install Wasabi step-by-step
Download the Wasabi package relevant to your operating system from wasabiwallet.io.
Verify the PGP signatures of the download.
Install Wasabi package as you would do any other software on your operating system.
Windows
Download the
.msi
installer of the latest Wasabi release.
Install Wasabi by double-clicking the
.msi
and following the GUI instructions.Make sure that you see this window that verifies the installer was signed by zkSNACKs Limited. Manual PGP verification is optional, as the package is signed and verified automatically on Windows.
Wasabi will be installed to your C:\Program Files\WasabiWallet\
folder. You will also have an icon in your Start Menu and on your Desktop. After the first run, a data folder will be created. Among others, here is where your wallet files and your logs reside.
Debian and Ubuntu
If you have already imported zkSNACKs' PGP public key, then jump to step 2.
Download zkSNACKs' PGP public key here, and then import it with
gpg --import PGP.txt
.Verify that the fingerprint is
${zksnacksPublicKeyFingerprint}
by running this commandgpg --list-keys zkSNACKs
.Download the latest Wasabi release, both the
.deb
package and the corresponding.asc
signature file.
Verify the signature in the Download repository with
gpg --verify Wasabi-${currentVersion}.deb.asc Wasabi-${currentVersion}.deb
. If the message returned saysGood signature from zkSNACKs
and that it was signed withPrimary key fingerprint: ${zksnacksPublicKeyFingerprint}
, then the software was not tampered with since the developer signed it.:::tip The output from the verify command may contain
WARNING: This key is not certified with a trusted signature!
. You can ignore this, but if you want to fully verify your download, you need to ask people you trust to confirm that the key fingerprint belongs to zkSNACKs. :::[GUI] Install by double-clicking and follow the GUI Instruction. [CLI] In the Download repository, execute the command
sudo apt install ./Wasabi-${currentVersion}.deb
to install Wasabi and after that run Wasabi by executingwassabee
.
After the first run, a data folder will be created. Among others, here is where your wallet files and your logs reside.
Other Linux
If you have already imported zkSNACKs' PGP public key, then jump to step 2.
Download zkSNACKs' PGP public key here, and then import it with
gpg --import PGP.txt
.Verify that the fingerprint is
${zksnacksPublicKeyFingerprint}
by running this commandgpg --list-keys zkSNACKs
.Download the latest Wasabi release, both the
.tar.gz
archive and the corresponding.asc
signature file.
In the Download folder, run
gpg --verify Wasabi-${currentVersion}.tar.gz.asc Wasabi-${currentVersion}.tar.gz
.If the message returned says
Good signature from zkSNACKs
and that it was signed withPrimary key fingerprint: ${zksnacksPublicKeyFingerprint}
, then the software was not tampered with since the developer signed it.:::tip The output from the verify command may contain
WARNING: This key is not certified with a trusted signature!
. You can ignore this, but if you want to fully verify your download, you need to ask people you trust to confirm that the key fingerprint belongs to zkSNACKs. :::Extract the archive while keeping the file permissions:
tar -pxzf Wasabi-${currentVersion}.tar.gz
.Run Wasabi by executing
./wassabee
.
After the first run, a data folder will be created. Among others, here is where your wallet files and your logs reside.
macOS
Download the
.dmg
package of Wasabi ${currentVersion} for your machine's processor. There are two types of packages for macOS, one for Intel and one for the Apple Silicon chip. If you're not sure what processor your device has, you can check it.
Double-click
.dmg
to open it.Install Wasabi by dragging it into your
Applications
folder.At first startup, there will be a pop-up that Wasabi was downloaded from the internet. Click on
Open
and restart Wasabi.
After the first run, a data folder will be created. Among others, here is where your wallet files and your logs reside.
Optional PGP Verification
If you have already imported zkSNACKs' PGP public key, then jump to step 4.
Copy zkSNACKs' PGP public key into a new
TextEdit
document and saving it aszkSNACKsPubKey.txt
. Before saving, you need to go toFormat / Make Plain Text
(otherwise TextEdit will not be able to save it as a .txt file).Open Terminal and go to the folder in which you saved the
zkSNACKsPubKey.txt
file and import the PGP public key withsudo gpg --import zkSNACKsPubKey.txt
. This should return the output:key 856348328949861E: public key "zkSNACKs <zksnacks@gmail.com>" imported
.Download the latest Wasabi release, both the
.dmg
package and the corresponding.asc
signature file.In the Download folder, run
sudo gpg --verify Wasabi-${currentVersion}.dmg.asc Wasabi-${currentVersion}.dmg
. If the message returned saysGood signature from zkSNACKs
and that it was signed withPrimary key fingerprint: ${zksnacksPublicKeyFingerprint}
, then the software was not tampered with since the developer signed it.:::tip The output from the verify command may contain
WARNING: This key is not certified with a trusted signature!
. You can ignore this, but if you want to fully verify your download, you need to ask people you trust to confirm that the key fingerprint belongs to zkSNACKs. :::
Last updated