52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
# Intro
|
|
|
|
[Electrum client](https://electrum.org/) is light bitcoin wallet software operates through supernodes (Electrum server instances actually).
|
|
|
|
Electrum client running as a daemon in docker container with JSON-RPC API enabled.
|
|
|
|
# Usage
|
|
|
|
Here are some example snippets to help you get started creating a container.
|
|
|
|
## docker-compose
|
|
|
|
```yaml
|
|
services:
|
|
electrum:
|
|
build:
|
|
context: https://git.bitdeals.org/private/electrum.git
|
|
dockerfile: ./docker/Dockerfile
|
|
image: registry.bitdeals.org/electrum
|
|
environment:
|
|
- ELECTRUM_TESTNET=0
|
|
- ELECTRUM_API_USER=<username>
|
|
- ELECTRUM_API_PASSWORD=<password>
|
|
expose:
|
|
- "7000"
|
|
```
|
|
|
|
## docker cli
|
|
|
|
```sh
|
|
docker run -d \
|
|
-e ELECTRUM_TESTNET=0 \
|
|
-e ELECTRUM_API_USER=electrum_api_user \
|
|
-e ELECTRUM_API_PASSWORD=electrum_api_password \
|
|
-p 127.0.0.1:7000:7000 \
|
|
registry.bitdeals.org/electrum
|
|
```
|
|
|
|
# Parameters
|
|
|
|
Container images are configured using parameters passed at runtime.
|
|
|
|
|Parameter|Function|
|
|
|:--------|:-------|
|
|
|-p 7000|JSON-RPC API port TCP|
|
|
|-e ELECTRUM_TESTNET=|Set 1 to enable bitcoin testnet mode. Default: `0`|
|
|
|-e ELECTRUM_API_USER=|JSON-RPC API user. Default: `electrum_api_user`|
|
|
|-e ELECTRUM_API_PASSWORD=|JSON-RPC API password. Default: `electrum_api_password`|
|
|
|-e USER_UID=|Electrum user id. Default: `2000`|
|
|
|-e USER_GID=|Electrum user gid. Default: `2000`|
|
|
|