chompomonim / docker-electrum-daemon

Electrum client running as a daemon in docker container

docker-electrum-daemon

Electrum client running as a daemon in docker container with JSON-RPC enabled.

Electrum client is light bitcoin wallet software operates through supernodes (Electrum server instances actually).

Don't confuse with Electrum server that use bitcoind and full blockchain data.

Star this project on Docker Hub 🌟 https://hub.docker.com/r/osminogin/electrum-daemon/

Ports

• 7000 - JSON-RPC port.

Volumes

• /data - usually on host it has a path /home/user/.electrum.

Getting started

docker

Running with Docker:

docker run --rm --name electrum-daemon \
    --publish 127.0.0.1:7000:7000 \
    --volume /srv/electrum:/data \
    osminogin/electrum-daemon

docker exec -it electrum-daemon electrum create
docker exec -it electrum-daemon electrum daemon load_wallet
docker exec -it electrum-daemon electrum daemon status
{
    "auto_connect": true,
    "blockchain_height": 505136,
    "connected": true,
    "fee_per_kb": 427171,
    "path": "/home/electrum/.electrum",
    "server": "us01.hamster.science",
    "server_height": 505136,
    "spv_nodes": 10,
    "version": "3.0.6",
    "wallets": {
        "/home/electrum/.electrum/wallets/default_wallet": true
    }
}

Running in testnet mode

docker run -d \
    -e "ELECTRUM_TESTNET=--testnet" \
    -e "ELECTRUM_XPUB=$xpub" \
    --name electrum-testnet \
    -p 7000:7000 \
    $(DOCKER_IMAGE):$(ELECTRUM_VERSION)

docker exec -it electrum-testnet electrum --testnet daemon status

Or alternatively, if you're cloning my repo, you can use make:

make docker_build
make run_testnet

API

• Electrum protocol specs
• API related sources

License

MIT