{{Header}} __FORCETOC__ {{Title| title=How-to: Use Electrum Bitcoin Wallet in {{project_name_long}} - Manual Installation }} {{#seo: |description=Manual installation from upstream (electrum.org) of Electrum AppImage. |image=Electrum.png }} [[File:Electrum.png|thumb|250px]] {{intro| Manual installation from upstream (electrum.org) of Electrum AppImage. }} = Introduction = See [[Electrum]] wiki page for introduction and warnings! Primarily refer to the [[Electrum]] wiki page! Use this page only in case newer versions of [[Electrum]] are desired! {{mbox | type = notice | image = [[File:Ambox_notice.png|40px|alt=Info]] | text = Prerequisite knowledge: refer to the [[Operating_System_Software_and_Updates#Frozen_Packages|Frozen Packages]] and [[Operating_System_Software_and_Updates#Application_Specific_Update_Indicators|Application Specific Update Indicators]] entries in the [[Operating_System_Software_and_Updates|Operating System Software and Updates]] chapter. }} {{Community_Support|scope=page}} = Install Electrum = == Installation Steps == {{Box|text= '''Note:''' The following instructions should be applied in {{project_name_workstation_long}} ([[Qubes|{{q_project_name_long}}]]: {{project_name_workstation_vm}}). {{IconSet|h1|1}} {{Open_a__product_ws_terminal}} {{IconSet|h1|2}} Import the gpg public key of Electrum developer Thomas Voegtlin. https://github.com/spesmilo/electrum/issues/4789 {{gpg key |url=scurl-download https://raw.githubusercontent.com/spesmilo/electrum/master/pubkeys/ThomasV.asc |source_filename=ThomasV.asc |fingerprint=6694D8DE7BE8EE5631BED9502BD5824B7F9470E6 |gpg_fingerprint_output= At the time of writing, the output is identical to the following image. '''Figure:''' ''Fingerprint Verification'' [[File:electrum_verify_gpg_fingerprint.png]] Key fingerprint = 6694 D8DE 7BE8 EE56 31BE D950 2BD5 824B 7F94 70E6 }} {{IconSet|h1|3}} Download the Electrum AppImage. Note: At the time of writing, electrum-4.7.0 was the latest stable release. Before starting the Electrum download, browse to [https://electrum.org/#download electrum.org/#download] to verify the correct file path. Then download the file with [[Secure_Downloads#Downloads_with_scurl_-_SSL_Command_Line_Downloader|scurl]]. To find the correct AppImage download: "Right-click" AppImage → "Select" Copy Link Location → "Append" to scurl command. {{CodeSelect|code= scurl-download https://download.electrum.org/4.7.0/electrum-4.7.0-x86_64.AppImage }} {{IconSet|h1|4}} Check the Electrum AppImage is not corrupted after download. Due to occasional DDoS attacks. To check the Electrum AppImage, run. {{CodeSelect|code= file electrum*.AppImage }} The following output indicates a corrupted and/or non-existent AppImage file. 
electrum-4.7.0-x86_64.AppImage: HTML document, ASCII text, with very long lines
In that case, delete the file and try downloading the AppImage again. {{IconSet|h1|5}} Download the corresponding gpg signature. It is necessary to verify the integrity of the AppImage with the correct signature. Note: If users downloaded a later Electrum version at step 3, then modify the following command to match the corresponding signature file. To find the correct signature file download: "Right-click" signature → "Select" Copy Link Location → "Append" to scurl command. {{CodeSelect|code= scurl-download https://download.electrum.org/4.7.0/electrum-4.7.0-x86_64.AppImage.ThomasV.asc }} {{IconSet|h1|6}} Verify the integrity of the AppImage. Note: This command must be run in the same directory as the downloaded AppImage and signature. {{CodeSelect|code= gpg --verify electrum-4.7.0-x86_64.AppImage.ThomasV.asc electrum-4.7.0-x86_64.AppImage }} {{GnuPG-Success}} '''Figure:''' ''Good Signature'' 
gpg: Signature made Mon 19 Jul 2021 02:22:33 PM EDT
gpg:                using RSA key 6694D8DE7BE8EE5631BED9502BD5824B7F9470E6
gpg: Good signature from "Thomas Voegtlin (https://electrum.org) " [unknown]
gpg:                 aka "ThomasV " [unknown]
gpg:                 aka "Thomas Voegtlin " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 6694 D8DE 7BE8 EE56 31BE  D950 2BD5 824B 7F94 70E6
[[File:electrum_gpg_good_signature.png]] {{GnuPG-Warning}} If the following "gpg: BAD signature" message appears, the AppImage has been corrupted or altered during the download process. '''Figure:''' ''Bad Signature'' [[File:Electrum_bad_gpg_signature.png]] In this event, delete both the AppImage and signature and either wait 10-15 minutes for the Tor circuits to change, or open up the [[Tor_Controller#Nyx|Nyx Tor Controller]] in {{project_name_gateway_long}} ([[Qubes|{{q_project_name_short}}]]: {{project_name_gateway_vm}}) and type "n" to create new Tor circuits. Wait for a random period of time before repeating the steps to download the AppImage and signature. {{IconSet|h1|7}} Change file permissions. Make the Electrum AppImage executable. {{CodeSelect|code= chmod +x electrum-4.7.0-x86_64.AppImage }} {{IconSet|h1|8}} Done. The installation of the Electrum AppImage has been completed. }} = Start Electrum = {{mbox | type = notice | image = [[File:Ambox_notice.png|40px|alt=Info]] | text = Users should create a wallet with a [[Passwords#Generating_Unbreakable_Passwords|strong password]]! }} Please refer to the official documentation at [https://docs.electrum.org/en/latest/ docs.electrum.org] for comprehensive instructions, as well as more advanced topics like [https://docs.electrum.org/en/latest/coldstorage.html Cold Storage] of private keys. To start Electrum on all platforms, run. {{CodeSelect|code= ./electrum-4.7.0-x86_64.AppImage }} [[Qubes|{{q_project_name_short}}]] users are recommended to configure a [https://github.com/Qubes-Community/Contents/blob/master/docs/security/split-bitcoin.md 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|Stream Isolation]] for more information). = Electrum: First Run = {{mbox | type = notice | image = [[File:Ambox_notice.png|40px|alt=Info]] | text = These steps enable [[Stream Isolation]] for the Electrum application. }} {{Box|text= {{IconSet|h1|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'' [[File:Electrum_select_server_manually.png]] {{IconSet|h1|2}} Change the proxy settings. The necessary settings are: * Proxy: SOCKS5 * Host: 10.152.152.10 * Port: 9111 Press Next and the application should be fully functional. '''Figure:''' ''SOCKS5 Proxy Configuration'' [[File:Electrum_use_proxy_socks5_.png]] '''Note:''' If Electrum is already set up but stream isolation was not enabled, then navigate to Tools → Network in Electrum to bring up the server and proxy settings. {{IconSet|h1|3}} Done. Electrum first run stream isolation configuration steps have been completed. }} = Add Application Launcher to Start Menu = {{mbox | type = notice | image = [[File:Ambox_notice.png|40px|alt=Info]] | text = This step is optional. }} {{Launcher |name=electrum |path=/home/user/electrum-4.7.0-x86_64.AppImage |categories=Other }} = Donations = After installing Electrum, please consider making a [[Donate|donation]] to {{project_name_short}} to keep it running for years to come. {{Pay_Bitcoin_Specific}} = Footnotes = {{reflist|close=1}} {{Footer}} [[Category:Documentation]]