Skip to content

Commit 51c1464

Browse files
doc: Add instructions to run CLN node with remote_hsmd_socket
1 parent be806dc commit 51c1464

File tree

1 file changed

+59
-0
lines changed

1 file changed

+59
-0
lines changed

doc/contribute-to-core-lightning/docker-images.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,3 +131,62 @@ docker exec -it <container-id-from-step2> bash
131131
docker run -it --rm --platform=linux/amd64 --network=host -v '/root/.lightning:/root/.lightning' -v '/root/.bitcoin:/root/.bitcoin' -e LIGHTNINGD_DATA=/root/.lightning elementsproject/lightningd:latest --network=regtest
132132

133133
```
134+
135+
## Using a pre-built VLS `remote_hsmd_socket` to replace the `hsmd` subdaemon:
136+
137+
1. This setup assumes that both `bitcoind` and `vlsd` will be running on your host system.
138+
139+
2. Start your `bitcoind` node on the local machine.
140+
141+
3. Start `vlsd` locally with your prefered configuration. For example:
142+
143+
```shell
144+
export LIGHTNING_VLS_DIR=/root/.lightning
145+
export GREENLIGHT_VERSION="v25.12"
146+
export VLS_CLN_VERSION="v25.12"
147+
export VLS_NETWORK="regtest"
148+
export BITCOIND_RPC_URL="http://user:password@127.0.0.1:18443"
149+
export RUST_LOG=info
150+
export RUST_BACKTRACE=1
151+
152+
/home/validating-lightning-signer/target/release/vlsd \
153+
--datadir "$LIGHTNING_VLS_DIR"/.lightning-signer \
154+
--network regtest \
155+
--connect http://127.0.0.1:7701 \
156+
--rpc-server-address 127.0.0.1 \
157+
--rpc-server-port 8000 \
158+
--rpc-user vlsuser \
159+
--rpc-pass vlspassword \
160+
--log-level info
161+
```
162+
163+
4. Finally, run the Core Lightning node after replacing subdaemon `hsmd` with pre-built `remote_hsmd_socket`:
164+
165+
```shell
166+
docker run -it --rm -d \
167+
--platform=linux/amd64 \
168+
--network=host \
169+
-v '/root/.lightning:/root/.lightning' \
170+
-v '/root/.bitcoin:/root/.bitcoin' \
171+
-e GREENLIGHT_VERSION="v25.12" \
172+
-e VLS_CLN_VERSION="v25.12" \
173+
-e VLS_NETWORK="regtest" \
174+
-e BITCOIND_RPC_URL="http://user:password@127.0.0.1:18443" \
175+
-e LIGHTNINGD_NETWORK=regtest \
176+
elementsproject/lightningd:v25.12 \
177+
--bitcoin-rpcconnect=0.0.0.0 \
178+
--bitcoin-rpcuser=user \
179+
--bitcoin-rpcpassword=password \
180+
--network=regtest \
181+
--database-upgrade=true \
182+
--bitcoin-datadir=/root/.bitcoin \
183+
--log-level=debug \
184+
--announce-addr=127.0.0.1:19750 \
185+
--bind-addr=localhost:8989 \
186+
--bind-addr=ws:127.0.0.1:5020 \
187+
--bind-addr=0.0.0.0:19750 \
188+
--bitcoin-rpcport=18443 \
189+
--clnrest-port=3020 \
190+
--grpc-port=9740 \
191+
--subdaemon=hsmd:/var/lib/vls/bin/remote_hsmd_socket
192+
```

0 commit comments

Comments
 (0)