|
| 1 | +# Connect to Your Dappnode Using Tailscale |
| 2 | + |
| 3 | +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. |
| 4 | + |
| 5 | +:::tip |
| 6 | +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. |
| 7 | +::: |
| 8 | + |
| 9 | +--- |
| 10 | + |
| 11 | +## Prerequisites |
| 12 | + |
| 13 | +Before starting, ensure you have: |
| 14 | + |
| 15 | +- A [Tailscale account](https://tailscale.com/). |
| 16 | +- Tailscale installed on your device. Download [here](https://tailscale.com/download) |
| 17 | +- Having access to your [Dappnode's Admin UI](https://my.dappnode) |
| 18 | + |
| 19 | +## Step 1: Create an Auth Key |
| 20 | + |
| 21 | +1. Visit [Tailscale Admin Settings](https://login.tailscale.com/admin/settings/keys). |
| 22 | + |
| 23 | +2. Create a new auth key. Any name will work. |
| 24 | + |
| 25 | +3. Save the key for the next step. |
| 26 | + |
| 27 | + |
| 28 | +## Step 2: Install Tailscale on Your Dappnode |
| 29 | + |
| 30 | +1. Access your [Dappnode's Admin UI](https://my.dappnode) |
| 31 | +2. Navigate to **Dappstore** and search for the `Tailscale` package. |
| 32 | +3. Click **Install** |
| 33 | +4. Go to the Tailscale package in **Packages** tab and enter the auth key you created during installation. |
| 34 | + |
| 35 | + |
| 36 | +Once installed, Tailscale will run as a service on your Dappnode. |
| 37 | + |
| 38 | +## Step 3: Configure Tailscale to Connect to Dappnode Internal Networks |
| 39 | + |
| 40 | +### a. Accept Advertised Routes from Your Dappnode |
| 41 | + |
| 42 | +1. Go to your [Tailscale Machines Dashboard](https://login.tailscale.com/admin/machines). |
| 43 | + |
| 44 | +2. Find your Dappnode device in the list of machines |
| 45 | +3. Open the "Edit Route Settings" modal and check the Subnet Route that appears. |
| 46 | + |
| 47 | + |
| 48 | +### b. Add a Custom Nameserver |
| 49 | + |
| 50 | +1. Go to your [Tailscale DNS Admin Panel](https://login.tailscale.com/admin/dns). |
| 51 | +2. Find the Nameservers section, click Add nameserver button and add a custom nameserver. |
| 52 | + |
| 53 | +3. Fill the popup with: |
| 54 | + - **Nameserver IP:** `172.33.1.2` |
| 55 | + - Activate "Restrict to domain" switch. |
| 56 | + - Set the domain as `dappnode`. |
| 57 | + |
| 58 | +## Step 4: Access Your Dappnode |
| 59 | + |
| 60 | +### a. Connect to Tailscale |
| 61 | + |
| 62 | +Ensure that your laptop, computer, or phone is connected to Tailscale. |
| 63 | + |
| 64 | +### b. Access Dappnode Services |
| 65 | + |
| 66 | +Visit [http://my.dappnode](http://my.dappnode) in your browser. |
| 67 | + |
| 68 | +:::warning |
| 69 | +Have 2 or more Dappnodes? It won't work out of the box. You won't be able to choose which one it connects to. |
| 70 | + |
| 71 | +You need to go to the machines you don't want to access and disable subnet routes. Your Tailscale will then direct you to the Dappnode that has subnets activated. |
| 72 | +::: |
| 73 | + |
| 74 | +--- |
| 75 | + |
| 76 | +If you encounter any issues or need further assistance, refer to the [Dappnode Community Forums](https://forum.dappnode.io/) or the [Tailscale Support](https://tailscale.com/support/). |
0 commit comments