ElectrumSV for Linux

ElectrumSV for Linux built from source with Docker

Table of Contents

• About
• Simple Usage
• Tested Distributions
• Troubleshooting
• Build Yourself
• Creating a New Release

About

ElectrumSV has no official release binary for Linux and building it from source is cumbersome. This project aims to simplify the usage of ElectrumSV on Linux by bundling it as a portable AppImage. It uses Docker to build the AppImage from the official source code, making it easy to run on any Linux distribution.

Simple Usage

• Download latest ElectrumSV-X.X.X-x86_64.AppImage from: https://github.com/flolu/electrumsv-linux/releases
• Make it executable: chmod +x ElectrumSV-X.X.X-x86_64.AppImage (or via right click in file manager)
• Run it: ./ElectrumSV-X.X.X-x86_64.AppImage (or open from file manager)

Tested Distributions

• Arch Linux
• TailsOS 7
• Fedora 42
• Ubuntu 24

Troubleshooting

• If you get an error about FUSE, run the AppImage with APPIMAGE_EXTRACT_AND_RUN=1 ./ElectrumSV-X.X.X-x86_64.AppImage
  • Alternatively install FUSE (https://github.com/appimage/appimagekit/wiki/fuse)
• If you get an error about Qt platform, try setting the platform to wayland via QT_QPA_PLATFORM=wayland ./ElectrumSV-X.X.X-x86_64.AppImage
• If you are using Tor, you need to enable the Tor proxy manually:
  • After opening ElectrumSV, go to Tools -> Network -> Proxy and enable "Use Tor proxy at port 9050"

Build Yourself

Requirements

• Linux
• Docker

Steps

• Clone this repository
• Run ./build-appimage.sh (this build a Dockerfile with all the build dependencies and then runs the Dockerfile to create the AppImage)
• Run it: ./ElectrumSV-X.X.X-x86_64.AppImage (or open from file manager)

Tips

• You can modify servers.json to add/remove your preferred servers (it will be copied to the AppImage)
• Inspect content of AppImage: ./ElectrumSV-X.X.X-x86_64.AppImage --appimage-extract (this creates a folder squashfs-root with the content of the AppImage)

Creating a new Release

• Set ELECTRUMSV_VERSION in build-appimage.sh
• Set ELECTRUMSV_VERSION in Dockerfile
• Set version in ASCI art of AppRun file
• Create a new tag in git: git tag -a vX.X.X -m "vX.X.X"
• Push the tag: git push origin vX.X.X
• Create a new release in GitHub and upload the generated AppImage from output/