A Docker container solution that combines a full Evrmore node with an ElectrumX server for EVR.
This repository contains the necessary files to build a Docker image that runs both an Evrmore full node and an ElectrumX server. This setup allows users to run their own Evrmore infrastructure for wallet connections and blockchain exploration.
The solution consists of:
- A full Evrmore node that maintains a complete copy of the Evrmore blockchain
- An ElectrumX server that provides a lightweight interface for Electrum-based wallets to connect to the Evrmore network
- Automatic SSL certificate generation for secure connections
- Persistent storage for both blockchain data and ElectrumX database
- IPv6 disabled by default in
evrmore.conf(only IPv4)
docker run -d --name evrx \
-p 8817:8817 \
-p 50001:50001 \
-p 50002:50002 \
-p 50004:50004 \
-p 8000:8000 \
-v evrmore-data:/home/evr/.evrmore \
-v electrumx-data:/home/evr/electrumx \
-e RPC_USER=yourname \
-e RPC_PASSWORD=yourpassword \
sebawilq/evrx:0.2Use the provided docker-compose.yaml:
docker-compose pull
docker-compose up -dIf you already have existing volumes from older installs, they are referenced as external to avoid accidental recreation.
docker-compose pull
docker-compose stop evrx
docker-compose rm -f evrx
docker-compose up -dThe Dockerfile builds an Ubuntu-based container that:
- Installs all necessary dependencies
- Creates an
evruser for running the services - Downloads and installs Evrmore
- Sets up a Python virtual environment
- Installs ElectrumX from the EvrmoreOrg repository
- Configures environment variables for both services
- Exposes the necessary ports for external connections
- Sets up the startup script
The start script handles:
- Activation of the Python virtual environment
- Generation of SSL certificates if they don't exist
- Creation of the Evrmore configuration file if needed
- Ensuring IPv6 is disabled (
onlynet=ipv4,listenonion=0) - Starting the Evrmore daemon in the background
- Waiting for Evrmore RPC before launching ElectrumX
- Starting the ElectrumX server in the background
- Keeping the container running and streaming logs
| Port | Service | Description |
|---|---|---|
| 8817 | Evrmore | RPC port for Evrmore node |
| 50001 | ElectrumX | TCP port for wallet connections |
| 50002 | ElectrumX | SSL port for secure wallet connections |
| 50004 | ElectrumX | WebSocket port for web-based clients |
| 8000 | ElectrumX | RPC/localhost port |
| Volume | Container Path | Description |
|---|---|---|
| evrmore-data | /home/evr/.evrmore | Persistent storage for the Evrmore blockchain data |
| electrumx-data | /home/evr/electrumx | Persistent storage for ElectrumX DB + SSL certs |
Notes:
- The ElectrumX database is stored under
/home/evr/electrumx/electrumx_db. - SSL certs are stored under
/home/evr/electrumx/ssl_cert.
| Variable | Default | Description |
|---|---|---|
| RPC_USER | yourname | Evrmore RPC username |
| RPC_PASSWORD | yourpassword | Evrmore RPC password |
| EVR_RPC_PORT | 8817 | Evrmore RPC port |
| DAEMON_URL | (auto) | ElectrumX daemon URL (auto-built from RPC creds) |
| SYNC_INTERVAL | 10 | Sync progress log interval in seconds |
| NO_COLOR | 0 | Set to 1 to disable ANSI colors in logs |
If you want to build the image yourself instead of using the pre-built one:
git clone https://github.com/WilQSL/Electrumx-EvrNode.git
cd Electrumx-EvrNode
docker build -t sebawilq/evrx:0.2 .When first starting the container, both the Evrmore node and ElectrumX server will need to synchronize with the network. This process can take a significant amount of time depending on your hardware and network connection.
The Evrmore node needs to download and validate the entire blockchain, while ElectrumX builds its database from the blockchain data. You can monitor the synchronization progress by checking the logs:
docker logs -f evrxYou can connect to the Evrmore RPC interface on port 8817. You'll need to set up authentication in the evrmore.conf file (auto-created if missing).
Example RPC command:
curl --user username:password --data-binary '{"jsonrpc":"1.0","id":"curltest","method":"getinfo","params":[]}' -H 'content-type: text/plain;' http://127.0.0.1:8817/Electrum-compatible wallets can connect to your ElectrumX server using:
- TCP: port 50001
- SSL: port 50002
- WebSocket: port 50004
The container streams both Evrmore and ElectrumX logs to docker logs -f evrx, with prefixes:
[evrmored]for Evrmore daemon[electrumx]for ElectrumX[sync]periodic Evrmore sync progress
If you recreate the container without the electrumx-data volume, SSL certs will be generated again.
To update to the latest version:
docker pull sebawilq/evrx:0.2
docker stop evrx
docker rm evrx
# Run the docker run command againThe blockchain and ElectrumX data are stored in Docker volumes. You can back these up using Docker's volume management commands:
# Create a backup of the Evrmore blockchain data
docker run --rm -v evrmore-data:/source -v $(pwd):/backup ubuntu tar -czvf /backup/evrmore-data-backup.tar.gz -C /source .
# Create a backup of the ElectrumX database + SSL
docker run --rm -v electrumx-data:/source -v $(pwd):/backup ubuntu tar -czvf /backup/electrumx-data-backup.tar.gz -C /source .-
Container exits immediately: Check the logs with
docker logs evrxto see if there are any error messages. -
ElectrumX not starting: The ElectrumX server waits for the Evrmore node to start. If the Evrmore node fails to start, ElectrumX won't start either.
-
Connection issues: Make sure the ports are correctly mapped and not blocked by your firewall.
Please refer to the original Evrmore and ElectrumX repositories for license information.
Contributions are welcome! Please feel free to submit a Pull Request.