Skip to content

Commit 7c3b6c2

Browse files
pablomendezroyoDiego Mazo
andauthored
Add tailscale docs (#461)
* Add tailscale docs * add screenshots and text details --------- Co-authored-by: Diego Mazo <dmazo@dappnode.io>
1 parent d71f221 commit 7c3b6c2

File tree

10 files changed

+89
-3
lines changed

10 files changed

+89
-3
lines changed

docs/user/access-your-dappnode/vpn/overview.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,21 +8,26 @@ It is not possible to use both Dappnode WiFi hotspot and VPN at the same time. I
88

99
## VPN Clients
1010

11-
### [WireGuard](/docs/user/access-your-dappnode/vpn/wireguard) (Recommended)
11+
### [Tailscale](/docs/user/access-your-dappnode/vpn/tailscale) (Recommended)
12+
13+
- Tailscale is a user-friendly VPN service that simplifies the process of connecting to your Dappnode.
14+
- It's an excellent choice if you're experiencing issues with port forwarding, UPnP, or CGNAT. [Learn more](https://tailscale.com/)
15+
16+
### [WireGuard](/docs/user/access-your-dappnode/vpn/wireguard)
17+
1218
- WireGuard is a newer, streamlined VPN protocol known for its simplicity, speed, and security.
1319
- It requires less configuration and is considered more efficient in terms of CPU usage. [Learn more](https://www.wireguard.com/)
1420

1521
### [OpenVPN](/docs/user/access-your-dappnode/vpn/openvpn)
22+
1623
- OpenVPN is a well-established VPN protocol praised for its security and reliability.
1724
- It's more versatile and can bypass most network restrictions and firewalls. [Learn more](https://openvpn.net/)
1825

1926
## Local vs. Remote Access
2027

2128
- **Local Access**: Connecting to your Dappnode when you're on the same local network. Generally, this means that your Dappnode machine and the device you're using to access it are connected to the same router.
22-
2329
- **Remote Access**: Connecting to your Dappnode from a different network or location. This is one of the major advantages of using a VPN.
2430

2531
:::info
2632
VPN provides a balance of security, versatility, and remote access capability. You can choose the VPN technology that best suits your needs and preferences, both fulfill the requirements of most users.
2733
:::
28-
Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
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+
![Authkey1](/img/authkey1.png)
23+
2. Create a new auth key. Any name will work.
24+
![Authkey2](/img/authkey2.png)
25+
3. Save the key for the next step.
26+
![Authkey3](/img/authkey3.png)
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+
![Authkey4](/img/authkey4.png)
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+
![Machinelist](/img/machinelist.png)
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+
![Subnetcheck](/img/subnetcheck.png)
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+
![Customserver](/img/customserver.png)
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/).

sidebars.js

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,11 @@ const sidebars = {
7373
label: "Overview",
7474
id: "user/access-your-dappnode/vpn/overview",
7575
},
76+
{
77+
type: "doc",
78+
label: "Tailscale",
79+
id: "user/access-your-dappnode/vpn/tailscale",
80+
},
7681
{
7782
type: "doc",
7883
label: "Wireguard",

static/img/authkey1.png

134 KB
Loading

static/img/authkey2.png

318 KB
Loading

static/img/authkey3.png

280 KB
Loading

static/img/authkey4.png

99.1 KB
Loading

static/img/customserver.png

277 KB
Loading

static/img/machinelist.png

156 KB
Loading

static/img/subnetcheck.png

616 KB
Loading

0 commit comments

Comments
 (0)