Connect Zeus wallet app with Tailscale to your lightning node

vrijdag 15 september 2023 - 431 woorden, 3 min read

This is a short explanation how I connected my Zeus wallet using Tailscale instead of Tor with lndconnect. The Tor connection between my Zeus wallet and Lightning was always very slow. Now my Zeus wallet loads instant without the hassle waiting for an active connection.

Back in 2021 I discovered Tailscale via the Selfhosted podcast. Tailscale is an application and service which creates one (private) network which connects all your devices on different networks. Each device has its own IP address within this network. When connected to this network, each device can talk to each other. This means I can connect to my node device at my office from my laptop. It does not matter how my laptop is connected as it has least a working internet connection. The same goes up for my mobile device where I use Tailscale to connect Zeus to my node.

In the documentation of Zeus you cannot find how to connect your Zeus app to your Tailscale network. There is only a section how to connect your Umbrel node with Zeus and Tailscale.

Before we can connect Zeus to your node with Tailscale:

  1. Create an account on Tailscale.com
  2. Install Tailscale on your mobile device
    -> iOS or Android or F-Droid
  3. Install Tailscale on your node device - Linux
  4. Copy the private IP address of your node
  5. Install lndconnect on your node device
  6. Install Zeus on your mobile device

Open your Zeus wallet app on your phone and go to Settings -> Connect a node and click on the + and this screen will be opened: IMG CD8752550F65 1

Here you select the Node interface depending on which Lightning Node implementation you are using. In my case it’s LND (REST).
Make sure you also uncheck the Use Tor and Certificate Verification option.

Now it’s time to open your terminal and run this lndconnect command on your node device:

lndconnect --host=<your_private_ip_address_from_tailscale> --port=8080 --nocert

Depending on your terminal, you maybe have to zoom out to see the full QR code before scanning it with your Zeus app.

Back to your Zeus application, press Scan LN node QR. Now scan the QR code with Zeus.

Before hit save config, remove the Use Tor option and replace all the onion address with that Tailscale IP of your node (see point 4). When you hit the save config button, Zeus will warn you about not verifying your connection with a certificate. As we are using a private network, this is not needed so click the button I understand, save node config.

Now you should be able to see your lightning and on-chain balances, send and receive payments and see a list of your lightning channels.

Used resources

If you need any help or would like to ask me something, don’t hesitate to contact me!


Sebastian Hagens @Sebastix
I work as creative webdeveloper & tech consultant and care about digital freedoms. Follow me:
or visit my contact page