How-to: Use Electrum Bitcoin Wallet in Whonix ™

From Whonix

Electrum Logo
Bitcoin Logo


Electrum [archive] is a popular Bitcoin wallet. According to the Electrum FAQ [archive]:

How does Electrum work? Electrum’s focus is speed, with low resource usage and simplifying Bitcoin. Startup times are instant because it operates in conjunction with high-performance servers that handle the most complicated parts of the Bitcoin system.

Electrum does not need to download/verify the blockchain and users store their private keys locally.

This is an advantage over some other Bitcoin wallets which are affected by this: if the third-party server were 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.


Ambox warning pn.svg.png Warning: This documentation is not comprehensive. It should not be viewed as a complete guide to cryptocurrency privacy and security, and does not cover all possible threats that can cause users to lose their cryptocurrency.

See also dedicated wiki pages:

Electrum is configured by electrum upstream default to use public third party servers. If users are not using their own self-hosted electrum server (ElectrumX), consider the following quote from the electrum upstream documentation Does Electrum trust servers? [archive]:


One of the servers, arbitrarily, is selected as the “main” server.

  • The client subscribes to its own addresses (nit: sha256 hashes of scriptPubKeys) so that it would be notified of new transactions touching them. It also synchronizes the existing history of its addresses. This means the client sacrifices some privacy to the server, as the server can now reasonably guess that all these addresses belong to the same entity.
  • As above, confirmed transactions are verified via SPV.
  • The server is trusted about unconfirmed transactions.
  • The server can lie by omission. That is, it can “forget” to mention (both confirmed and unconfirmed) transactions that are relevant to the client.
  • The main server is also used for fee estimates, and is trusted with those (low-high sanity limits are applied in the client)
  • The main server is also used to broadcast the transactions the client makes.


There can be no blanket recommendation for all users which Bitcoin wallet should be used. It depends on:

  • Technical skill.
  • Personal risk assignment.
  • Financial value in Bitcoin.
  • Time.
  • And probably other factors as well.

While Electrum has better usability (is easier to use), above warnings apply. However, for best security, the official Bitcoin client (bitcoin-qt) should be seriously considered for balances of Bitcoin representing serious financial value. For reasons, see Bitcoin Core.

Install Electrum[edit]


Installed by default in Whonix-Workstation ™.

Version Numbers[edit]

Should the user wish to use a newer version of Electrum than available in the electrum package [archive] since Whonix ™ is based on Debian, the user can optionally install Electrum using the usual instructions from the Electrum website. Recommendations from the safely installing software wiki page such as Verifying Software Signatures applies. See also Install Newer Software Versions.

It is possible to uninstall the electrum package but and uninstallation is optional if Electrum is manually installed in home folder.

See also Electrum, Manual Installation.

Start Electrum[edit]

Info Users should create a wallet with a strong password!

Please refer to the official Electrum documentation [archive] for comprehensive instructions, as well as more advanced topics like Cold Storage [archive] of private keys.

To start Electrum from start menu.

Start MenuInternetElectrum

To start Electrum from command line, run.


Qubes-Whonix ™ users are recommended to configure a Split Bitcoin Wallet [archive] 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[edit]

Info These steps enable Stream Isolation for the Electrum application.

warning Warning:

This is a notice for users of the ElectrumX server. Do not set up stream isolation if electrum should be used in combination with a self-hosted ElectrumX server running inside the same virtual machine since that would circumvent the isolating proxy setup.

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?".

Choose Select server manually and press Next.

Figure: Server Setting

Electrum select server manually.png

2. Change the proxy settings. This is useful for Stream Isolation.

The necessary settings are:

  • Proxy: SOCKS5
  • Host:
  • Port: 9111

Press Next and the application should be fully functional.

Figure: SOCKS5 Proxy Configuration

Electrum use proxy socks5 .png

Note: If Electrum is already set up but stream isolation was not enabled, then navigate to ToolsNetwork in Electrum to bring up the server and proxy settings.


To avoid any issues with Whonix ™ meta package removal, first install the dummy-dependency package.

Install dummy-dependency.

1. Update the package lists.

sudo apt update

2. Upgrade the system.

sudo apt full-upgrade

3. Install the dummy-dependency package.

Using apt command line parameter --no-install-recommends is in most cases optional.

sudo apt install --no-install-recommends dummy-dependency

4. Done.

The procedure of installing dummy-dependency is complete.

Remove the electrum package.

sudo apt purge electrum

Done, removal of the electrum package is complete.

See Also[edit]


After installing Electrum, please consider making a donation to Whonix ™ to keep it running for many years to come.

Donate Bitcoin (BTC) to Whonix ™.

Bitcoin accepted here 35wdTVzyYGzRd7W2Wb2dunw3v5Am14sxPX

Whonix donate bitcoin.png


Fosshost is sponsors Kicksecure ™ stage server Logo box.png
Fosshost About Advertisements

Search engines: YaCy | Qwant | ecosia | MetaGer | peekier | Whonix ™ Wiki

Follow: 1024px-Telegram 2019 Logo.svg.png Iconfinder Apple Mail 2697658.png Twitter.png Facebook.png Rss.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Support: Discourse logo.png

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contribute

Whonix donate bitcoin.png Monero donate Whonix.png United Federation of Planets 1000px.png

Twitter-share-button.png Facebook-share-button.png Telegram-share.png Iconfinder Apple Mail 2697658.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Want to help create awesome, up-to-date screenshots for the Whonix ™ wiki? Help is most welcome!

https link onion link Priority Support | Investors | Professional Support

Whonix | © ENCRYPTED SUPPORT LP | Heckert gnu.big.png Freedom Software / Osi standard logo 0.png Open Source (Why?)

The personal opinions of moderators or contributors to the Whonix ™ project do not represent the project as a whole.

By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent.