{{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 }} [[image: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}}). '''1.''' {{Open_a__product_ws_terminal}} '''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= In early-2019, the output is identical to the following image. '''Figure:''' ''Fingerprint Verification'' [[Image:electrum_verify_gpg_fingerprint.png]] Key fingerprint = 6694 D8DE 7BE8 EE56 31BE D950 2BD5 824B 7F94 70E6 }} '''3.''' Download the Electrum AppImage. Note: At the time of writing, electrum-4.4.6 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 image download: "Right-click" AppImage"Select" Copy Link LocationAppend to scurl command. {{CodeSelect|code= scurl-download https://download.electrum.org/4.4.6/electrum-4.4.6-x86_64.AppImage }} '''5.''' Check the Electrum AppImage is not corrupted after download. Due to recent 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.4.6-x86_64.AppImage: HTML document, ASCII text, with very long lines
In that case, delete the file and try downloading the AppImage again. '''6.''' 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 4, 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.4.6/electrum-4.4.6-x86_64.AppImage.ThomasV.asc }} '''7.''' Verify the integrity of the AppImage image. Note: This command must be run in the same directory as the downloaded AppImage and signature. {{CodeSelect|code= gpg --verify electrum-4.4.6-x86_64.AppImage.ThomasV.asc electrum-4.4.6-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
[[Image: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'' [[Image: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. '''8.''' Change file permissions. Make the electrum AppImage executable. {{CodeSelect|code= chmod +x electrum-4.4.6-x86_64.AppImage }} '''9.''' 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://electrum.readthedocs.io/en/latest/ docs.electrum.org] for comprehensive instructions, as well as more advanced topics like [https://electrum.readthedocs.io/en/latest/coldstorage.html Cold Storage] of private keys. To start Electrum on all platforms, run. {{CodeSelect|code= ./electrum-4.4.6-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= '''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'' [[Image:Electrum_select_server_manually.png]] '''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'' [[Image: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. }} = 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.4.6-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]]