# ElectrumX

ElectrumX is a Python Bitcoin Electrum server that connects to a full Bitcoin node to serve self-hosted Electrum wallet clients, enabling private address-history lookups and optional public server exposure. It is open source and self-hosted, installable on Docker Hub, Unraid and Umbrel.

Canonical page: https://ourlocalhost.com/app/1931/electrumx

## Description

ElectrumX is a Python Bitcoin Electrum server that connects to a full Bitcoin node to serve self-hosted Electrum wallet clients, enabling private address-history lookups and optional public server exposure.

## Platform availability

Available on 2 of 10 platforms: Unraid, Umbrel.

## Health score

65/100 (Good), based on 5 of 5 factors.
- Maintained: 91 (last commit 17 days ago)
- Popular: 55 (573 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)
- Security check: 72 (no serious findings, CI, tests, OpenSSF Scorecard 3.8/10)

## Links

- GitHub: https://github.com/spesmilo/electrumx
- Docker Hub: https://hub.docker.com/r/ofawx/electrumx/
- Unraid: https://ca.unraid.net/apps/electrumx-0aqo6jw19jb4u8?q=electrumx
- Umbrel: https://apps.umbrel.com/app/electrumx

## Common questions

### What should I know about Docker memory buffers for ElectrumX?

Docker can automatically use all available memory for buffers unless you limit it manually. A bigger cache can help speed initial sync, and you can restart with the default after it finishes.

### How should I configure TLS certificates in a Dockerized ElectrumX setup?

Rename the private key to server.key and the certificate to server.crt, then give permissions to the electrum group on the certificates.

### Can a self-hosted ElectrumX join the public Electrum server network?

Yes, the server can be exposed publicly and joined to the public network of servers via peer discovery.

### What should I expect when using a local onion address for ElectrumX?

One user found that Electrum would not accept their local onion address on the same Pi, and suspected it was related to indexing.

## Alternatives

- Phoenixd: Phoenixd is the server equivalent of the Phoenix self-custodial Bitcoin Lightning wallet.
- bitcoin-knots

---
Source: Our Local Host (https://ourlocalhost.com/app/1931/electrumx), the self-hosted and open-source app directory.
