Guide - Tailscale on Umbrel

Guide - Tailscale on Umbrel

Tired of waiting for your wallet to connect over tor? This guide shows you how to use Tailscale to connect your bitcoin wallet to your umbrel bitcoin node.

Tailscale

Tailscale connects your online devices together using end to end encryption. It can be used to connect your phone running a bitcoin wallet to your Umbrel bitcoin node.

You will log into Tailscale, install Tailscale on your Umbrel and Phone and connect your wallet.

⚠️
Warning: This guide uses the Tailscale web UI at login.tailscale.com with a network controller run by Tailscale Inc. If this controller gets compromised it could edit your access control list. This would allow new devices to be added to your private network which would have access to your devices. It is technically possible to manually configure your own network controller. This guide will be updated if an easy way to do this is available.

Tailscale Account

Use simplelogin to create a new email address, make a new GitHub account with this email, set up 2FA and use it to sign into Tailscale at https://login.tailscale.com.

Tailscale App on Umbrel

Install the Tailscale app from the Umbrel app store. Open it and follow the setup (login with your GitHub username and password).

Install Tailscale from the Umbrel App Store

Tailscale on Mobile

You can only run one system managed VPN at a time, so check that there is no other VPN running on your phone. If you are using the CalyxOS Android operating system you can create a work profile to isolate your bitcoin wallets in a separate profile which has Tailscale installed.

Download the Tailscale app from your app store and follow the setup. You are prompted to login with your account details. Toggle the VPN on (1).

Look up your IP for your Umbrel node in the Tailscale app, it will be in the format 100.x.x.x (2).

You can also use the web admin panel https://login.tailscale.com/admin/machines

Tailscale admin panel

Connecting to Zeus

In the Umbrel home screen open the Core Lightning app.

In your Zeus wallet node configuration

  1. Change LND to c-ligtning-REST
  2. Press the SCAN C-LIGHTNING-REST QR button and scan the QR code shown in the Core Lightning Umbrel app (1) above
  3. Name your configuration Umbrel (Tailscale)
  4. Change the Host to the Tailscale IP address. It should start with http://100.

Press save node config.

Steps for setting your node configuration in Zeus

Complete

Your Zeus wallet is now connected to your Umbrel

Privacy

The Tailscale server (tailscale.com) knows your IP addresses but the packets are end to end encrypted. The private keys to decrypt the packets never leave your devices.

Alternative Methods

There are other ways to connect your mobile wallet to your home node.

Tor

Tor can connect your bitcoin wallet to your node, even if they are on different networks, using an onion service. There is no signup requirement and no central party coordinating the connections. When it works, it is hard to beat. Unfortunately tor is vulnerable to denial of service attacks which have reduced network reliability. This can cause long delays when loading a bitcoin wallet to make a payment or check a balance. It is useful to have an alternate connection option ready to use if tor is unavailable.

Manual Configuration

A technical person could set a static IP address, configure their network firewall and open public-facing ports. For a non technical person this can be hard, and opens your home network to attack from the outside.

Lightning Node Connect

A new system called Lightning Node Connect is under development which simplifies the connection between a node and a web or mobile application. It will be for LND users only and will also require LITD/Lightning terminal.

ZeroTier

Similar in practice to Tailscale, easy to install on a Raspiblitz. Guide


Thank you to Selfbankt, BitcoinQnA and Evan Kaloudis for their feedback and suggestions to the ZeroTier guide on which this guide was based.