Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
124 changes: 95 additions & 29 deletions docs/user/access-your-dappnode/vpn/tailscale.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,65 +12,131 @@ Using Tailscale is an excellent alternative if you're experiencing issues with U

Before starting, ensure you have:

- Access to your [Dappnode's Admin UI](http://my.dappnode).
- A [Tailscale account](https://tailscale.com/).
- Tailscale installed on your device. Download [here](https://tailscale.com/download)
- Having access to your [Dappnode's Admin UI](https://my.dappnode)
- Tailscale installed on the device you want to access your Dappnode from. Download [here](https://tailscale.com/download).

## Step 1: Create an Auth Key
## Setting Up Tailscale

1. Visit [Tailscale Admin Settings](https://login.tailscale.com/admin/settings/keys).
![Authkey1](/img/authkey1.png)
### 1. Create an Auth Key

1. Log in to Tailscale and navigate to [Tailscale Admin Settings](https://login.tailscale.com/admin/settings/keys). Click on ***Generate auth key***.
<p align="center">
<img width="80%"src="/img/authkey1.png"/>
</p>
2. Create a new auth key. Any name will work.
![Authkey2](/img/authkey2.png)
3. Save the key for the next step.
![Authkey3](/img/authkey3.png)
<p align="center">
<img width="50%"src="/img/authkey2.png"/>
</p>
3. Save the key for the next step. Do not share this key with anyone.
<p align="center">
<img width="50%"src="/img/authkey3.png"/>
</p>

## Step 2: Install Tailscale on Your Dappnode
### 2. Install Tailscale on Your Dappnode

1. Access your [Dappnode's Admin UI](https://my.dappnode)
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.
![Authkey4](/img/authkey4.png)
<p align="center">
<img width="80%"src="/img/authkey4.png"/>
</p>

Once installed, Tailscale will run as a service on your Dappnode.
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.

## Step 3: Configure Tailscale to Connect to Dappnode Internal Networks
### 3. Configure Tailscale to Connect to Dappnode Internal Networks

### a. Accept Advertised Routes from Your Dappnode
#### a. Accept Advertised Routes from Your Dappnode

1. Go to your [Tailscale Machines Dashboard](https://login.tailscale.com/admin/machines).
![Machinelist](/img/machinelist.png)
<p align="center">
<img width="80%"src="/img/machinelist.png"/>
</p>
2. Find your Dappnode device in the list of machines
3. Open the "Edit Route Settings" modal and check the Subnet Route that appears.
![Subnetcheck](/img/subnetcheck.png)
<p align="center">
<img width="50%"src="/img/subnetcheck.png"/>
</p>

### b. Add a Custom Nameserver
#### b. Add a Custom Nameserver

1. Go to your [Tailscale DNS Admin Panel](https://login.tailscale.com/admin/dns).
2. Find the Nameservers section, click Add nameserver button and add a custom nameserver.
![Customserver](/img/customserver.png)
2. Find the Nameservers section, click on **"Add nameserver"** and add a custom nameserver.
<p align="center">
<img width="50%"src="/img/customserver.png"/>
</p>

3. Fill the popup with:
- **Nameserver IP:** `172.33.1.2`
- Activate "Restrict to domain" switch.
- Activate **"Restrict to domain"** switch.
- Set the domain as `dappnode`.

## Step 4: Access Your Dappnode

### a. Connect to Tailscale
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


<details>
<summary><b>macOS</b></summary>

Ensure that your laptop, computer, or phone is connected to Tailscale.
1. Open tailscale app in your finder
2. Go to the top bar and click the tailscale logo (9 dots)
<p align="center">
<img width="50%"src="/img/tailscale-2.png"/>
</p>
3. Activate the switch to connect.

### b. Access Dappnode Services
</details>

Visit [http://my.dappnode](http://my.dappnode) in your browser.
<details>
<summary> <b>Linux</b></summary>

:::warning
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.
1. Open up a terminal and run the following command:
```bash
sudo tailscale up --accept-routes
```

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.
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.

3. To stop Tailscale in any moment, run the following command:
```bash
sudo tailscale down
```
:::info
Having trouble using Tailscale on Linux? Check out the [Tailscale Linux documentation](https://tailscale.com/kb/1031/install-linux) for more information.
:::

---
</details>

<details>
<summary><b>Windows</b></summary>

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.

<p align="center">
<img width="50%"src="/img/tailscalewindows.png"/>
</p>

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

:::info
Having trouble using Tailscale on Windows? Check out the [Tailscale Windows documentation](https://tailscale.com/kb/1022/install-windows) for more information.
:::

</details>

<details>
<summary><b>Android</b></summary>

1. Open your Tailscale app
2. Connect to your dappnode by clicking on the "Connect" button.

</details>

<br/>


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/).
If you encounter any issues or need further assistance, refer to Dappnode's [Discord](https://discord.gg/dappnode), the [Dappnode Community Forums](https://forum.dappnode.io/), or [Tailscale Support](https://tailscale.com/support/).
Binary file added static/img/tailscale-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/tailscalewindows.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading