osminogin/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 - user data folder (on host it usually has a path /home/user/.electrum).

Getting started

docker

Running with Docker:

docker run --rm --name electrum \
    --env TESTNET=false \
    --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
    }
}

docker-compose

docker-compose.yml to see minimal working setup. When running in production, you can use this as a guide.

docker-compose up
docker-compose exec electrum electrum daemon status
docker-compose exec electrum electrum create
docker-compose exec electrum electrum daemon load_wallet
curl --data-binary '{"id":"1","method":"listaddresses"}' http://electrum:electrumz@localhost:7000

❗Warning❗

Always link electrum daemon to containers or bind to localhost directly and not expose 7000 port for security reasons.

API

• Electrum protocol specs
• API related sources

License

See LICENSE

docker-electrum-daemon's Issues

No longer able to connect to the RPC

On commit #2, I was able to query electrum via RPC. Now, I can't. I'm not sure why and I'll give it a shot tomorrow. Might have something to do with the removal of socat (whose usage I'm not familiar with).

rpcpassword CHANGE REQUIRED

Please fix the readme - if I follow the instructions https://hub.docker.com/r/osminogin/electrum-daemon/ I get an error "electrum setconfig rpcpassword electrumz '#' XXX: CHANGE 'REQUIRED!'".
Tell me how to fix it. I'm not good at building docker images. and any changes I make to the downloaded image are undone on startup.

(make build) ==> chown: unknown user

Hi,

I have this error when i run 'make build':
`
chown: unknown user electrum
The command '/bin/sh -c mkdir -p /data ${ELECTRUM_HOME} && ln -sf /data ${ELECTRUM_HOME}/.electrum && chown ${ELECTRUM_USER} ${ELECTRUM_HOME}/.electrum /data' returned a non-zero code: 1
make: *** [Makefile:20 : docker_build] Erreur 1

If you have an idea !? :)
`

Electrum-2.9.3 version

Hi, I would like to see option for new version or some kind of tag

Wallet deleted when container restarted?

Hello,

I am new to docker, I set this image up like this in docker-compose.yml:

electrum:
    image: osminogin/electrum-daemon:3.3.8
    expose:
      - 7000
    env_file:
      - .electrum.dev
    volumes:
      - electrum-data:/data
volumes:
  electrum-data:

But when I run electrum create in the container, it creates the wallet in .electrum/wallets but when I restart its gone, how can I make it persist? From what i've seen there is no simple way to make the anonymous volume re-use the older ones