Electrum Wallet Desktop

Electrum wallet Desktop is a well-established, feature-rich Bitcoin wallet for power users that supports most hardware wallets.

Difficulty: Easy

Requirements

Installation

On your local computer, download, verify, and install Electrum Wallet.

Using the instructions on this page:

  • Download the required version for your OS

  • Download the signature file

  • Verify the signature following the instructions on the page depending on your OS

  • Install Electrum Wallet Desktop

Configuration

Force single server Electrum connection to only your node

To preserve privacy, we will constrain Electrum to only connect to a single server (your MiniBolt). How to do this depends on whether you are connecting via Local Area Network or via Tor and the operating system that you use on your regular computer.

Local connection

If you plan to use Electrum from only within your own secured local area network, you can use the local connection details.

  • Linux

    • Execute this command in your Linux terminal to -1 (connect to single server only) -s (server address)

./electrum -1 -s minibolt.local:50002:s
  • Windows

    • Find the new Electrum desktop shortcut, right-click it, go to "Properties", and click the shortcut tab at the top bar, in the box named target, put "-1 -s minibolt.local:50002:s" after "electrum.exe" (replace minibolt.local with your node IP if necessary)

"C:\Program Files (x86)\Electrum\electrum.exe" -1 -s minibolt.local:50002:s
  • Apply, accept, and execute by double-clicking on the new shortcut

  • macOS

    • Execute this command in the Terminal application to -1 (connect to single server only) -s (server address)

/Applications/Electrum.app/Contents/MacOS/run_electrum -1 -s minibolt.local:50002:s
  • After using this command for the first run, close Electrum, and open the Electrum config file with the following customized command

nano /Users/<YOUR_PERSONAL_COMPUTER_USERNAME>/.electrum/config
  • Modify the file to include the following lines

"auto_connect": false,
"oneserver": true,
"server": "minibolt.local:50002:s",

After opening a wallet or creating a new one, Electrum will indicate an active connection to a local server with a green dot in the bottom right corner of the screen.

Remote connection over Tor

To connect over Tor, you will need to have Tor installed on the client computer running Electrum.

By OS:

  • Windows: download, install, and run Tor Browser

    • The application must be started manually and run in the background when you want to connect over Tor.

    • By default, when you have Tor Browser running, Tor proxy is available on port 9150, but if you want to have 9050 available too, you can run background service on port 9050, executing "tor.exe" file on the installation path route you chose during Tor Browser installation and following the next subpath ...\Tor Browser\Browser\TorBrowser\Tor\tor.exe"

  • Linux: only need to execute (sudo apt install tor) on the command line and ensure that the Tor service is working and listening at the default ports 9050 and 9150

sudo ss -tulpn | grep tor | grep LISTEN

Expected output:

tcp   LISTEN 0  4096   127.0.0.1:9050   0.0.0.0:*    users:(("tor",pid=1847,fd=6))
tcp   LISTEN 0  4096   127.0.0.1:9051   0.0.0.0:*    users:(("tor",pid=1847,fd=7))
  • macOS: download, verify, install, and run Tor Browser

    • The application must be started manually when you want to connect over Tor

    • By default, when you have Tor Browser running, Tor proxy is available on port 9150, use this port instead of 9050 port

Now we need to specify the Tor address for the Electrum Server and the local Tor proxy port in the Electrum Wallet configuration.

First, get the onion address of your Electrum server directly on the MiniBolt, depending on whether you chose the Electrs or Fulcrum service

  • For Electrs

sudo cat /var/lib/tor/hidden_service_electrs/hostname

Example of expected output:

> ab...yz.onion
  • For Fulcrum

sudo cat /var/lib/tor/hidden_service_fulcrum/hostname

Example of expected output:

> ab...yz.onion.onion

Now, execute Electrum Wallet choosing the correct way depending on your OS (replace "9050" with "9150" if you choose to run the Tor Browser)

  • Linux

    • Execute this command in your Linux terminal to -1 (connect to single server only) -s (server address)

./electrum -1 -s ab...yz.onion:50002:s -p socks5:localhost:9050
  • Windows

    • With your new shortcut created after installation in Desktop, right-click it and go to properties, click the shortcut tab at the top bar, and in the box named target put "-1 -s ab...yz.onion:50002:s -p socks5:localhost:9050" after "electrum.exe", apply, accept, and execute doing double-clicking on our new shortcut

 C:\Program Files (x86)\Electrum\electrum.exe -1 -s ab...yz.onion:50002:s -p socks5:localhost:9050
  • macOS

    • Open the Tor browser

    • In the Terminal application, run the following command

/Applications/Electrum.app/Contents/MacOS/run_electrum -1 -s ab...yz.onion:50002:s -p socks5:localhost:9050

After opening a wallet or creating a new one, Electrum will indicate an active connection to a Tor server with a blue dot in the bottom right corner of the screen.

🚨 Try to check "Use Tor proxy at port 9050" or "Use Tor proxy at port 9150" in "Proxy" settings tab if not connected for you

Troubleshooting note: For those who already had Electrum installed on their systems with old server connections, is needed to clear the pre-existing cert of the certs folder. Follow these instructions:

  1. Shutdown Electrum if it's running

  2. Go to C:\Users\<yourUsername>\AppData\Roaming\Electrum\certs (or ~/.electrum/certs on Linux afaik)

  3. Delete the certificate that corresponds to your node IP address

  4. Start Electrum again

Last updated