Skip to content

Commit f6e26b5

Browse files
authored
pwa tailscale docs (#489)
* pwa tailscale docs * reconnect tip * info to warning * clarify namespaces
1 parent 984f267 commit f6e26b5

File tree

4 files changed

+26
-10
lines changed

4 files changed

+26
-10
lines changed

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

Lines changed: 26 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,12 @@ Once installed, Tailscale will run as as any other package on your Dappnode. In
5151

5252
### 3. Configure Tailscale to Connect to Dappnode Internal Networks
5353

54+
To ensure you can access your Dappnode's internal networks and services, you need to configure Tailscale to accept routes and set up custom DNS servers. There are two main steps to complete this configuration. Accepting advertised routes and adding custom nameservers (DNS).
55+
5456
#### a. Accept Advertised Routes from Your Dappnode
5557

58+
Dappnode advertises its internal networks through Tailscale, allowing you to access services like the Dappnode Admin UI and other packages. To ensure these routes are accepted:
59+
5660
1. Go to your [Tailscale Machines Dashboard](https://login.tailscale.com/admin/machines).
5761
<p align="center">
5862
<img width="80%"src="/img/machinelist.png"/>
@@ -72,22 +76,34 @@ Once installed, Tailscale will run as as any other package on your Dappnode. In
7276
</p>
7377

7478
3. Fill the popup with:
75-
- **Nameserver IP:** `172.33.1.2`
76-
- Activate **"Restrict to domain"** switch.
77-
- Set the domain as `dappnode`.
78-
79-
4. Add another custom nameserver, this time with the following values:
8079
- **Nameserver IP:** `10.20.0.2`
81-
- Activate **"Restrict to domain"** switch.
82-
- Set the domain as `dappnode.private`.
8380

84-
The end result should look like this:
81+
4. Click and activate the "Override DNS servers" switch.
82+
83+
The end result should look like this, with two nameservers active:
8584
<p align="center">
86-
<img width="50%"src="/img/dnsconfig.png"/>
85+
<img width="50%"src="/img/tailscalednsconfignormal.png"/>
8786
</p>
8887

8988

90-
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.
89+
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.
90+
91+
:::warning
92+
If you were already connected to your Dappnode with Tailscale, you may need to disconnect and reconnect to apply the new DNS settings.
93+
:::
94+
95+
<details>
96+
<summary><b>Advanced DNS configuration</b></summary>
97+
98+
If you don't want to use the default Dappnode DNS server for everything, you can set up Dappnode's DNS server to only resolve Dappnode services. For this, you will need to add a custom DNS server for each dappnode service, restricted to a specific domain.
99+
100+
The following screenshot shows a configuration that only uses Dappnode's DNS server for services under the `dappnode`, `dappnode.private` and `dyndns.dappnode` domains, while using the default Tailscale DNS server for everything else.
101+
102+
<p align="center">
103+
<img width="50%"src="/img/tailscalednsadvanced.png"/>
104+
</p>
105+
106+
</details>
91107

92108
### 4. Connecting to Dappnode with Tailscale
93109

static/img/dnsconfig.png

-44.9 KB
Binary file not shown.
70.9 KB
Loading
42.6 KB
Loading

0 commit comments

Comments
 (0)