https://docs.wasabiwallet.io/assets/InstallPackage-Cm6_NZ00.js

1import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c}from"./app-CYzRTHpK.js";import"./Logo_without_text_with_bg_dark_with_yt-DuBM0wre.js";import"./DownloadMac-Bm_pSVUl.js";var l=JSON.parse(`{"path":"/using-wasabi/InstallPackage.html","title":"Install-package","lang":"en-US","frontmatter":{"title":"Install-package","description":"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 open-source, non-custodial and privacy-focused Bitcoin wallet for desktop."},"git":{"updatedTime":1789501305000,"contributors":[{"name":"MarnixCroes","username":"MarnixCroes","email":"[email protected]","commits":1,"url":"https://github.com/MarnixCroes"}],"changelog":[{"hash":"ec05d90b383aef35c87ae15a3b915fb0d68fc21f","time":1789501305000,"email":"[email protected]","author":"Marnix Croes","message":"Merge pull request #2131 from WalletWasabi/bump-version-2.8.3"}]},"filePathRelative":"using-wasabi/InstallPackage.md"}`),u={name:`InstallPackage.md`},d={class:`table-of-contents`};function f(c,l,u,f,p,m){let h=t(`router-link`),g=t(`RouteLink`);return s(),o(`div`,null,[l[36]||=i(`h1`,{id:`install-package`,tabindex:`-1`},[i(`a`,{class:`header-anchor`,href:`#install-package`},[i(`span`,null,`Install package`)])],-1),i(`nav`,d,[i(`ul`,null,[i(`li`,null,[a(h,{to:`#introduction`},{default:r(()=>[...l[0]||=[e(`Introduction`,-1)]]),_:1})]),i(`li`,null,[a(h,{to:`#install-wasabi-step-by-step`},{default:r(()=>[...l[1]||=[e(`Install Wasabi step-by-step`,-1)]]),_:1})]),i(`li`,null,[a(h,{to:`#windows`},{default:r(()=>[...l[2]||=[e(`Windows`,-1)]]),_:1})]),i(`li`,null,[a(h,{to:`#debian-and-ubuntu`},{default:r(()=>[...l[3]||=[e(`Debian and Ubuntu`,-1)]]),_:1})]),i(`li`,null,[a(h,{to:`#linux-appimage`},{default:r(()=>[...l[4]||=[e(`Linux AppImage`,-1)]]),_:1})]),i(`li`,null,[a(h,{to:`#other-linux`},{default:r(()=>[...l[5]||=[e(`Other Linux`,-1)]]),_:1})]),i(`li`,null,[a(h,{to:`#macos`},{default:r(()=>[...l[6]||=[e(`macOS`,-1)]]),_:1}),i(`ul`,null,[i(`li`,null,[a(h,{to:`#optional-pgp-verification`},{default:r(()=>[...l[7]||=[e(`Optional PGP Verification`,-1)]]),_:1})])])])])]),l[37]||=i(`h2`,{id:`introduction`,tabindex:`-1`},[i(`a`,{class:`header-anchor`,href:`#introduction`},[i(`span`,null,`Introduction`)])],-1),i(`p`,null,[l[9]||=e(`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 `,-1),a(g,{to:`/using-wasabi/BuildSource.html`},{default:r(()=>[...l[8]||=[e(`tutorial here`,-1)]]),_:1}),l[10]||=e(`.`,-1)]),l[38]||=n(`<p>Download the packages either from the official <a href="https://wasabiwallet.io" target="_blank" rel="noopener noreferrer">WasabiWallet.io</a> clearnet website or for your privacy&#39;s sake, from the official Tor onion service <a href="http://wasabiukrxmkdgve5kynjztuovbg43uxcbcxn6y2okcrsg7gb6jdmbad.onion" target="_blank" rel="noopener noreferrer">http://wasabiukrxmkdgve5kynjztuovbg43uxcbcxn6y2okcrsg7gb6jdmbad.onion</a>.</p><p><img src="/DownloadAll.png" alt="Operating systems supported by Wasabi Wallet" title="Operating systems supported by Wasabi Wallet"></p><p>Although there is automatic signature verification on Windows and macOS, it is still recommended to manually <strong>VERIFY PGP SIGNATURES</strong> of the downloaded package with zkSNACKs&#39; PGP public key <a href="https://github.com/WalletWasabi/WalletWasabi/blob/master/PGP.txt" target="_blank" rel="noopener noreferrer">6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</a> before installing Wasabi. This protects you against malicious phishing sites giving you back-doored wallet software. If you have personally verified zkSNACKs&#39; PGP public key <a href="https://github.com/WalletWasabi/WalletWasabi/blob/master/PGP.txt" target="_blank" rel="noopener noreferrer">6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</a> and you are familiar with the <a href="https://security.stackexchange.com/questions/147447/gpg-why-is-my-trusted-key-not-certified-with-a-trusted-signature" target="_blank" rel="noopener noreferrer">Web Of Trust</a>, please consider also <a href="https://www.gnupg.org/gph/en/manual/x334.html" target="_blank" rel="noopener noreferrer">signing it</a>.</p><div class="hint-container tip"><p class="hint-container-title">Always</p><p>Don&#39;t trust - Verify!</p></div><h2 id="install-wasabi-step-by-step" tabindex="-1"><a class="header-anchor" href="#install-wasabi-step-by-step"><span>Install Wasabi step-by-step</span></a></h2><ol><li>Download the Wasabi package relevant to your operating system from <a href="https://wasabiwallet.io" target="_blank" rel="noopener noreferrer">wasabiwallet.io</a>.</li><li>Verify the PGP signatures of the download.</li><li>Install Wasabi package as you would do any other software on your operating system.</li></ol><hr><h2 id="windows" tabindex="-1"><a class="header-anchor" href="#windows"><span>Windows</span></a></h2><ol><li>

1<a href="https://wasabiwallet.io/#download" target="_blank" rel="noopener noreferrer">Download</a> the <code>.msi</code> installer of the latest Wasabi release.</li></ol><p><img src="/DownloadWindows.png" alt="Download Wasabi Wallet for Windows" title="Download Wasabi Wallet for Windows"></p><ol start="2"><li><p>Install Wasabi by double-clicking the <code>.msi</code> and following the GUI instructions.</p></li><li><p>Make sure that you see this window that verifies the installer was signed by Lucas Ontivero (Wasabi maintainer). Manual PGP verification is optional, as the package is signed and verified automatically on Windows.</p></li></ol>`,11),i(`p`,null,[l[12]||=e(`Wasabi will be installed to your `,-1),l[13]||=i(`code`,null,`C:\\Program Files\\WasabiWallet\\`,-1),l[14]||=e(` folder. You will also have an icon in your Start Menu and on your Desktop. After the first run, a `,-1),a(g,{to:`/FAQ/FAQ-UseWasabi.html#where-can-i-find-the-wasabi-data-folder`},{default:r(()=>[...l[11]||=[e(`data folder`,-1)]]),_:1}),l[15]||=e(` will be created. Among others, here is where your wallet files and your logs reside.`,-1)]),l[39]||=n(`<h2 id="debian-and-ubuntu" tabindex="-1"><a class="header-anchor" href="#debian-and-ubuntu"><span>Debian and Ubuntu</span></a></h2><p>If you have already imported zkSNACKs&#39; PGP public key, then jump to step 2.</p><ol><li><p>Download zkSNACKs&#39; PGP public key <a href="https://github.com/WalletWasabi/WalletWasabi/blob/master/PGP.txt" target="_blank" rel="noopener noreferrer">here</a>, and then import it with <code>gpg --import PGP.txt</code>.</p><p>Verify that the fingerprint is <code>6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code> by running this command <code>gpg --list-keys zkSNACKs</code>.</p></li><li><p><a href="https://wasabiwallet.io/#download" target="_blank" rel="noopener noreferrer">Download</a> the latest Wasabi release, both the <code>.deb</code> package and the corresponding <code>.asc</code> signature file.</p></li></ol><p><img src="/DownloadDeb.png" alt="Download Wasabi Wallet for Debian" title="Download Wasabi Wallet for Debian"></p><ol start="3"><li><p>Verify the signature in the Download repository with <code>gpg --verify Wasabi-2.8.3.deb.asc Wasabi-2.8.3.deb</code>. If the message returned says <code>Good signature from zkSNACKs</code> and that it was signed with <code>Primary key fingerprint: 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code>, then the software was not tampered with since the developer signed it.</p><div class="hint-container tip"><p class="hint-container-title">Tips</p><p>The output from the verify command may contain <code>WARNING: This key is not certified with a trusted signature!</code>. 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.</p></div></li><li><p>[GUI] Install by double-clicking and follow the GUI Instruction. <br> [CLI] In the Download repository, execute the command <code>sudo apt install ./Wasabi-2.8.3.deb</code> to install Wasabi and after that run Wasabi by executing <code>wassabee</code>.</p></li></ol>`,5),i(`p`,null,[l[17]||=e(`After the first run, a `,-1),a(g,{to:`/FAQ/FAQ-UseWasabi.html#where-can-i-find-the-wasabi-data-folder`},{default:r(()=>[...l[16]||=[e(`data folder`,-1)]]),_:1}),l[18]||=e(` will be created. Among others, here is where your wallet files and your logs reside.`,-1)]),l[40]||=n(`<h2 id="linux-appimage" tabindex="-1"><a class="header-anchor" href="#linux-appimage"><span>Linux AppImage</span></a></h2><p>If you have already imported zkSNACKs&#39; PGP public key, then jump to step 2.</p><ol><li><p>Download zkSNACKs&#39; PGP public key <a href="https://github.com/WalletWasabi/WalletWasabi/blob/master/PGP.txt" target="_blank" rel="noopener noreferrer">here</a>, and then import it with <code>gpg --import PGP.txt</code>.</p><p>Verify that the fingerprint is <code>6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code> by running this command <code>gpg --list-keys zkSNACKs</code>.</p></li><li><p>

1<a href="https://wasabiwallet.io/#download" target="_blank" rel="noopener noreferrer">Download</a> the latest Wasabi release, both the <code>.AppImage</code> package and the corresponding <code>.asc</code> signature file.</p></li></ol><p><img src="/DownloadAppImage.png" alt="Download Wasabi Wallet for Linux AppImage" title="Download Wasabi Wallet for Linux AppImage"></p><ol start="3"><li><p>In the Download folder, run <code>gpg --verify Wasabi-2.8.3.AppImage.asc Wasabi-2.8.3.AppImage</code>.</p><p>If the message returned says <code>Good signature from zkSNACKs</code> and that it was signed with <code>Primary key fingerprint: 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code>, then the software was not tampered with since the developer signed it.</p><div class="hint-container tip"><p class="hint-container-title">Tips</p><p>The output from the verify command may contain <code>WARNING: This key is not certified with a trusted signature!</code>. 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.</p></div></li><li><p>Make the package executable while keeping the file permissions: <code>chmod +x Wasabi-2.8.3.AppImage</code>.</p></li><li><p>Run Wasabi by executing <code>./Wasabi-2.8.3.AppImage</code>.</p></li></ol>`,5),i(`p`,null,[l[20]||=e(`After the first run, a `,-1),a(g,{to:`/FAQ/FAQ-UseWasabi.html#where-can-i-find-the-wasabi-data-folder`},{default:r(()=>[...l[19]||=[e(`data folder`,-1)]]),_:1}),l[21]||=e(` will be created. Among others, here is where your wallet files and your logs reside.`,-1)]),l[41]||=n(`<h2 id="other-linux" tabindex="-1"><a class="header-anchor" href="#other-linux"><span>Other Linux</span></a></h2><p>If you have already imported zkSNACKs&#39; PGP public key, then jump to step 2.</p><ol><li><p>Download zkSNACKs&#39; PGP public key <a href="https://github.com/WalletWasabi/WalletWasabi/blob/master/PGP.txt" target="_blank" rel="noopener noreferrer">here</a>, and then import it with <code>gpg --import PGP.txt</code>.</p><p>Verify that the fingerprint is <code>6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code> by running this command <code>gpg --list-keys zkSNACKs</code>.</p></li><li><p><a href="https://wasabiwallet.io/#download" target="_blank" rel="noopener noreferrer">Download</a> the latest Wasabi release, both the <code>.tar.gz</code> archive and the corresponding <code>.asc</code> signature file.</p></li></ol><p><img src="/DownloadTar.png" alt="Download Wasabi Wallet for Linux" title="Download Wasabi Wallet for Linux"></p><ol start="3"><li><p>In the Download folder, run <code>gpg --verify Wasabi-2.8.3-linux-x64.tar.gz.asc Wasabi-2.8.3-linux-x64.tar.gz</code>.</p><p>If the message returned says <code>Good signature from zkSNACKs</code> and that it was signed with <code>Primary key fingerprint: 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code>, then the software was not tampered with since the developer signed it.</p><div class="hint-container tip"><p class="hint-container-title">Tips</p><p>The output from the verify command may contain <code>WARNING: This key is not certified with a trusted signature!</code>. 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.</p></div></li><li><p>Extract the archive while keeping the file permissions: <code>tar -pxzf Wasabi-2.8.3-linux-x64.tar.gz</code>.</p></li><li><p>Run Wasabi by executing <code>./wassabee</code>.</p></li></ol>`,5),i(`p`,null,[l[23]||=e(`After the first run, a `,-1),a(g,{to:`/FAQ/FAQ-UseWasabi.html#where-can-i-find-the-wasabi-data-folder`},{default:r(()=>[...l[22]||=[e(`data folder`,-1)]]),_:1}),l[24]||=e(` will be created. Among others, here is where your wallet files and your logs reside.`,-1)]),l[42]||=i(`h2`,{id:`macos`,tabindex:`-1`},[i(`a`,{class:`header-anchor`,href:`#macos`},[i(`span`,null,`macOS`)])],-1),i(`ol`,null,[i(`li`,null,[l[26]||=i(`a`,{href:`https://wasabiwallet.io/#download`,target:`_blank`,rel:`noopener noreferrer`},`Download`,-1),l[27]||=e(` the `,-1),l[28]||=i(`code`,null,`.dmg`,-1),l[29]||=e(` package of Wasabi 2.8.3 for your machine's processor. `,-1),a(g,{to:`/FAQ/FAQ-Installation.html#why-are-there-two-different-packages-for-macos-intel-and-apple-silicon`},{default:r(()=>[...l[25]||=[e(`There are two types of packages for macOS`,-1)]]),_:1}),l[30]||=e(`, one for Intel and one for the Apple Silicon chip. If you're not sure what processor your device has, you can `,-1),l[31]||=i(`a`,{href:`https://www.howtogeek.com/706226/how-to-check-if-your-mac-is-using-an-intel-or-apple-silicon-processor/`,target:`_blank`,rel:`noopener noreferrer`},`check it`,-1),l[32]||=e(`.`,-1)])]),l[43]||=n(`<p><img src="/DownloadMac.png" alt="Download Wasabi Wallet for macOS" title="Download Wasabi Wallet for macOS"></p><ol start="2"><li><p>Double-click <code>.dmg</code> to open it.</p></li><li><p>Install Wasabi by dragging it into your <code>Applications</code> folder.</p></li><li><p>At first startup, there will be a pop-up that Wasabi was downloaded from the internet. Click on <code>Open</code> and restart Wasabi.</p></li></ol>`,2),i(`p`,null,[l[34]||=e(`After the first run, a `,-1),a(g,{to:`/FAQ/FAQ-UseWasabi.html#where-can-i-find-the-wasabi-data-folder`},{default:r(()=>[...l[33]||=[e(`data folder`,-1)]]),_:1}),l[35]||=e(` will be created. Among others, here is where your wallet files and your logs reside.`,-1)]),l[44]||=n(`<h3 id="optional-pgp-verification" tabindex="-1"><a class="header-anchor" href="#optional-pgp-verification"><span>Optional PGP Verification</span></a></h3><p>If you have already imported zkSNACKs&#39; PGP public key, then jump to step 4.</p><ol><li><p><a href="https://www.gnupg.org/download/index.html" target="_blank" rel="noopener noreferrer">Get GnuPG</a>.</p></li><li><p>Copy <a href="https://github.com/WalletWasabi/WalletWasabi/blob/master/PGP.txt" target="_blank" rel="noopener noreferrer">zkSNACKs&#39; PGP public key</a> into a new <code>TextEdit</code> document and saving it as <code>zkSNACKsPubKey.txt</code>. Before saving, you need to go to <code>Format / Make Plain Text</code> (otherwise TextEdit will not be able to save it as a .txt file).</p></li><li><p>Open Terminal and go to the folder in which you saved the <code>zkSNACKsPubKey.txt</code> file and import the PGP public key with <code>sudo gpg --import zkSNACKsPubKey.txt</code>. This should return the output: <code>key 856348328949861E: public key &quot;zkSNACKs &lt;[email protected]&gt;&quot; imported</code>.</p></li><li><p>

1<a href="https://wasabiwallet.io/#download" target="_blank" rel="noopener noreferrer">Download</a> the latest Wasabi release, both the <code>.dmg</code> package and the corresponding <code>.asc</code> signature file.</p><p><img src="/DownloadMac.png" alt=""></p></li><li><p>In the Download folder, run <code>sudo gpg --verify Wasabi-2.8.3.dmg.asc Wasabi-2.8.3.dmg</code>. If the message returned says <code>Good signature from zkSNACKs</code> and that it was signed with <code>Primary key fingerprint: 6FB3 872B 5D42 292F 5992 0797 8563 4832 8949 861E</code>, then the software was not tampered with since the developer signed it.</p><div class="hint-container tip"><p class="hint-container-title">Tips</p><p>The output from the verify command may contain <code>WARNING: This key is not certified with a trusted signature!</code>. 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.</p></div></li></ol><p><a href="https://youtu.be/ry6qIyQmzRE" target="_blank" rel="noopener noreferrer"><img src="/Logo_without_text_with_bg_dark_with_yt.png" alt="Watch the video"></a></p><p><a href="https://youtu.be/QHIpEYYqddE" target="_blank" rel="noopener noreferrer"><img src="/Logo_without_text_with_bg_dark_with_yt.png" alt="Watch the video"></a></p>`,5)])}var p=c(u,[[`render`,f]]);export{l as _pageData,p as default};