How-to: Use Electrum Bitcoin Wallet in Whonix
Electrum is a popular Bitcoin wallet. The non-official thin client Electrum appears to be well-designed. It does not need to download/verify the blockchain and users store their private keys locally, which eliminates the need to trust third-party severs. 
Note: To mitigate the risk of a known exploit, Electrum versions older than v3.3 are prevented from connecting to public servers.   This step was necessary to prevent user exposure to phishing messages.  If you have an Electrum version older than v3.3 installed, then it is necessary to upgrade.
While it is strongly recommended to install software from the Debian repositories, the latest available package is too old and will not connect to public servers. This means Debian's official package manager (
APT) cannot be used to install a functional Electrum version.
The best option at present is to install Electrum from the official website. The following instructions provide steps to verify the AppImage, but keep in mind the risks involved with manual software installation. Always make every effort to follow Best Practices when installing software. 
Users should create a wallet with a strong password!
To start Electrum on all platforms, run.
Qubes-Whonix users are recommended to configure a Split Bitcoin Wallet to better protect their private keys. To protect against identity correlation through Tor circuit sharing, follow the instructions below (see Stream Isolation for more information).
Electrum: First Run
These steps enable Stream Isolation for the Electrum application.
1. Configure a manual server connection.
When Electrum is started for the first time, users are met with the prompt:
"How do you want to connect to a server?".
Select server manually and press
Figure: Server Setting
2. Change the proxy settings.
The necessary settings are:
Next and the application should be fully functional.
Figure: SOCKS5 Proxy Configuration
Note: If Electrum is already set up but stream isolation was not enabled, then navigate to
Network in Electrum to bring up the server and proxy settings.
Add Application Launcher to Start Menu
This step is optional.
mkdir -p ~/.local/share/applications
Create a new file
~/.local/share/applications/electrum.desktop using an editor.
Paste the following contents.
[Desktop Entry] Type=Application Exec=/home/user/electrum-3.3.4-x86_64.AppImage Name=electrum Categories=Other
The procedure is now complete.
You can find the launcher here:
Start Menu ->
After having installed Electrum, please consider making a donation to Whonix to keep it running for the years to come.
Donate Bitcoin (BTC) to Whonix.
- Some Bitcoin wallets other than Electrum are affected by this: if the third-party server was ever compromised, all of the users' bitcoins could be stolen. There is also the possibility that the third-party could lose a user's private keys or walk away with them.
- For further details, see: Github Electrum issues.
Installing software best practices:
- Prefer APT - Generally, the safest option is to stick with Debian's official package manager APT.
- Avoid Third Party Package Managers - There are many third party package managers besides APT, however they lack the security safeguards that are standard in Debian.
- Avoid Manual Software Installation - Generally avoid the manual installation of packages, even trusted ones.
- Always Verify Signatures - For greater system security, it is strongly recommended to avoid installing unsigned software.
- Prefer Packages from Debian Stable Repository - Users who decide to install new software after considering the risks should preference Debian's stable repository, rather than the testing / unstable or third party repositories.
- To find the correct image download:
Copy Link Location->
to scurl command.
- To find the correct signature file download:
Copy Link Location->
to scurl command
No user support in comments. See Support.
Comments will be deleted after some time. Specifically after comments have been addressed in form of wiki enhancements. See Wiki Comments Policy.
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! Read, understand and agree to Conditions for Contributions to Whonix, then Edit! Edits are held for moderation.
Copyright (C) 2012 - 2019 ENCRYPTED SUPPORT LP. Whonix is a trademark. Whonix is a licensee of the Open Invention Network. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Freedom Software license as Whonix itself. (Why?)