Skip to main content

Connect to Your Dappnode Using Tailscale

Tailscale is a secure, peer-to-peer VPN solution that simplifies connecting to your Dappnode without requiring complex port forwarding, solving issues such as UPnP not being recognized, routers behind CGNAT, or other port forwarding challenges. This guide walks you through setting up Tailscale to access your Dappnode.

tip

Using Tailscale is an excellent alternative if you're experiencing issues with UPnP, CGNAT, or port forwarding. It's easy to set up and ensures a seamless connection to your Dappnode.

Prerequisites​

Before starting, ensure you have:

Setting Up Tailscale​

1. Create an Auth Key​

  1. Log in to Tailscale and navigate to Tailscale Admin Settings. Click on Generate auth key.

  1. Create a new auth key. Any name will work.

  1. Save the key for the next step. Do not share this key with anyone.

2. Install Tailscale on Your Dappnode​

  1. Access your Dappnode's Admin UI
  2. Navigate to Dappstore and search for the Tailscale package.
  3. Click Install
  4. Go to the Tailscale package in Packages tab and enter the auth key you created during installation.

Once installed, Tailscale will run as as any other package on your Dappnode. In order to connect to your Dappnode with Tailscale, this package will need to be running.

3. Configure Tailscale to Connect to Dappnode Internal Networks​

a. Accept Advertised Routes from Your Dappnode​

  1. Go to your Tailscale Machines Dashboard.

  1. Find your Dappnode device in the list of machines
  2. Open the "Edit Route Settings" modal and check the Subnet Route that appears.

b. Add a Custom Nameserver​

  1. Go to your Tailscale DNS Admin Panel.
  2. Find the Nameservers section, click on "Add nameserver" and add a custom nameserver.

  1. Fill the popup with:
    • Nameserver IP: 172.33.1.2
    • Activate "Restrict to domain" switch.
    • Set the domain as dappnode.

That's it! You've successfully configured Tailscale to connect to your Dappnode. All that's left is to install Tailscale on the device you want to access your Dappnode from.

4. Connecting to Dappnode with Tailscale​

macOS
  1. Open tailscale app in your finder
  2. Go to the top bar and click the tailscale logo (9 dots)

  1. Activate the switch to connect.
Linux
  1. Open up a terminal and run the following command:
sudo tailscale up --accept-routes

  1. If it's your first time using Tailscale in this device, a browser window may open asking to connect this device to your Tailscale account. Click on "Connect". That's it! You're now connected to your Dappnode.

  2. To stop Tailscale in any moment, run the following command:

sudo tailscale down
note

Having trouble using Tailscale on Linux? Check out the Tailscale Linux documentation for more information.

Windows
  1. Once installed, Tailscale's icon will appear in your system tray. Click on it.
  2. If it's your first time using Tailscale in this device, a browser window may open asking to connect this device to your Tailscale account. Click on "Connect". That's it! You're now connected to your Dappnode.

  1. To disconnect tailscale, right click on the icon on the system tray and log out or exit the application.
note

Having trouble using Tailscale on Windows? Check out the Tailscale Windows documentation for more information.

iOS
  1. Download Tailscale from the App Store.
  2. Open your Tailscale app and Log in
  3. Connect to your dappnode by clicking on the "Connect" button.
note

Having trouble installing Tailscale on iOS? Check out the Tailscale iOS documentation for more information.

Android
  1. Download Tailscale from the Google Play Store.
  2. Open your Tailscale app and Log in
  3. Connect to your dappnode by clicking on the "Connect" button.
note

Having trouble installing Tailscale on Android? Check out the Tailscale Android documentation for more information.


5. Do you have two Dappnodes?​

It won't work automatically and you won't be able to choose which one connects.

You have to go to the machines that you don't want to access and disable subnet routes. Your tailscale will direct you to the one that does have the subnets activated.

If you encounter any issues or need further assistance, refer to Dappnode's Discord, the Dappnode Community Forums, or Tailscale Support.