For development or testing, or to spin up a btgd
backend alongside lnd
,
check out the documentation at docker/README.md.
To use Docker in a production environment, you can run lnd
by first creating
a Docker container, adding the appropriate command-line options as parameters.
$ docker create --name=lnd bitcoingold/lnd [command-line options]
Then, just start the container:
$ docker start lnd
A Docker volume will be created with your .lnd
directory automatically, and will
persist through container restarts.
You can also optionally manually specify a local folder to be used as a volume:
$ docker create --name=lnd -v /media/lnd-docker/:/root/.lnd bitcoingold/lnd [command-line options]
Here is an example testnet lnd
that uses Neutrino:
$ docker create --name lnd-testnet bitcoingold/lnd --bitcoingold.active --bitcoingold.testnet --bitcoingold.node=neutrino --neutrino.connect=faucet.lightning.community
Start the container:
$ docker start lnd-testnet
Create a wallet (and write down the seed):
$ docker exec -it lnd-testnet lncli create
Confirm lnd
has begun to synchronize:
$ docker logs lnd-testnet
[snipped]
2018-05-01 02:28:01.201 [INF] RPCS: RPC server listening on 127.0.0.1:10009
2018-05-01 02:28:01.201 [INF] LTND: Waiting for chain backend to finish sync, start_height=2546
2018-05-01 02:28:01.201 [INF] RPCS: gRPC proxy started at 127.0.0.1:8080
2018-05-01 02:28:08.999 [INF] LNWL: Caught up to height 10000
2018-05-01 02:28:09.872 [INF] BTCN: Processed 10547 blocks in the last 10.23s (height 10547, 2012-05-28 05:02:32 +0000 UTC)
This is a simple example, it is possible to use any command-line options necessary
to expose RPC ports, use btgd
or bgoldd
, or add additional chains.