Electrum Bitcoin Wallet

From Whonix
Jump to navigation Jump to search

How-to: Use Electrum Bitcoin Wallet in Whonix

Electrum Logo
Bitcoin Logo


Electrumarchive.org is a popular Bitcoin wallet. According to the Electrum FAQarchive.org:

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.


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.org:


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]

Info Prerequisite knowledge: refer to the Frozen Packages and Application Specific Update Indicators entries in the Operating System Software and Updates chapter.

Should the user wish to use a newer version of Electrum than available in the packages.debian.org electrum packagearchive.org since Whonix is based on Debian, the user can optionally install Electrum using the usual instructions from the Electrum website. Recommendations from the Kicksecure logo safely installing software The Web Archive Onion Version wiki page such as Verifying Software Signatures applies. See also Kicksecure logo Install Newer Software Versions The Web Archive Onion Version .

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 documentationarchive.org for comprehensive instructions, as well as more advanced topics like Cold Storagearchive.org 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 Walletarchive.org 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

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

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.


1. Dummy dependency installation.

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

Install package(s) dummy-dependency-electrum. Follow steps A to D.

A. Platform specific notice.

B. Kicksecure logo Update the package lists and upgrade the system The Web Archive Onion Version .

sudo apt update && sudo apt full-upgrade

C. Install the dummy-dependency-electrum package(s).

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

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

D. Platform specific notice.

E. Done.

The procedure of installing package(s) dummy-dependency-electrum is complete.

2. Remove the electrum package.

sudo apt purge electrum

3. Done.

Removal of the electrum package has been completed.

See Also[edit]


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

Bitcoin accepted here Donate Bitcoin (BTC) to Whonix.



We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 12 year success story and maybe DONATE!