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

1. In your Start9 dashboard, make sure you have C-Lightning-REST enabled.
   • Services > Core Lightning > Config > Advanced > Plugins > C-Lightning-REST
2. SSH to your Start9, see documentation for help: https://docs.start9.com/0.3.5.x/user-manual/ssh
3. Access the root account: sudo -i
4. 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 or Unexpected end of JSON, run echo '{}' > /root/.docker/config.json

1. 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

1. On your phone, connect to Tailscale
2. On your Start9, copy your REST Macaroon (Hex) for Zeus wallet setup
   • Services > Core Lightning > Properties > REST Properties > REST Macaroon (Hex)
3. 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!