c-lightning-REST with Tailscale on Start9
c-lightning-REST with Tailscale on Start9
This guide gives you commands to run additional containers on Start9. This is not officially supported and will break on reboot. You can always run the containers again to restore the setup. The containers are used to provide access, via Tailscale, to Core Lightning's c-lightning-REST plugin
Start9 setup
- In your Start9 dashboard, make sure you have C-Lightning-REST enabled.
- Services > Core Lightning > Config > Advanced > Plugins > C-Lightning-REST
- SSH to your Start9, see documentation for help:
https://docs.start9.com/0.3.5.x/user-manual/ssh - Access the root account:
sudo -i
- Run tailscaled and alpine/socat containers:
podman run -d \
--name=tailscaled.embassy \
-v /dev/net/tun:/dev/net/tun \
-v /var/lib:/var/lib \
-e TS_HOSTNAME=tailscaled \
--network=host \
--cap-add=NET_ADMIN \
--cap-add=NET_RAW \
docker.io/tailscale/tailscale:stable
podman run -d \
--name=socat.embassy \
--publish 4321:1234 \
--network=start9 \
docker.io/alpine/socat \
tcp-listen:1234,fork,reuseaddr tcp:c-lightning.embassy:3001
- Note, if you see errors related to
/root/.docker/config.json
orUnexpected end of JSON
, runecho '{}' > /root/.docker/config.json
- Check the status of tailscaled and log in
podman exec tailscaled.embassy tailscale --socket /tmp/tailscaled.sock status
# example output
Logged out.
Log in at: https://login.tailscale.com/a/1fa8e293dfd108
Zeus wallet setup
- On your phone, connect to Tailscale
- On your Start9, copy your REST Macaroon (Hex) for Zeus wallet setup
- Services > Core Lightning > Properties > REST Properties > REST Macaroon (Hex)
- In Zeus wallet, add a new node
- Settings > (tap the active node) > +
Setting | Value |
---|---|
Node interface | Core Lightning (c-lightning-Rest) |
Host | tailscaled.YOUR_TAILNET_DOMAIN |
Macaroon (Hex format) | see last step |
REST Port | 4321 |
Certificate Verification | disabled |
SAVE NODE CONFIG
- Note, you can find YOUR_TAILNET_DOMAN at
https://login.tailscale.com/admin/dns
Enjoy!