> For the complete documentation index, see [llms.txt](https://docs.ava.do/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ava.do/your-avado/connecting-to-your-avado/remote-access-with-tailscale.md).

# Remote access with Tailscale

Open your whole AVADO, the Admin and every app, from your phone or laptop wherever you are, with your own free Tailscale account. Five steps.

With the **Tailscale** app, your phone and laptop reach your AVADO from anywhere, just like at home: the Admin at <http://my.ava.do> and every app (Vaultwarden, Immich, Home Assistant and the others).

* It is **free**: you use your own Tailscale account. Nothing goes through AVADO's servers.
* The connection is private and encrypted, directly between your devices and your AVADO.
* AVADO Remote Connect (ZeroTier) keeps working as before. You can use both.

**Before you start:** make a free account at [tailscale.com](https://tailscale.com). You need it in every step.

## Install

1. Open the AVADO Admin at <http://my.ava.do>.
2. Click **DappStore**, find **Tailscale** and click **Install**.
3. The installer has an optional field **Tailscale auth key**. You can leave it empty and paste the key on the app's page in step 1 below.
4. Open the app from **My DApps** (the **Setup** tab), or go to <http://tailscale.my.ava.do>.

The page is a checklist of five steps. It ticks each step off by itself when it is done.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fgit-blob-f9cc856c8a1b656fc08033761d38f479aa9c5015%2Ftailscale-page.png?alt=media" alt="The Tailscale page: Set up Tailscale, with five steps: Connect this AVADO, Approve its routes, Add the AVADO as DNS, Connect your phone or laptop, Open my.ava.do"><figcaption><p>The Tailscale page before you start.</p></figcaption></figure>

## Set it up in 5 steps

### 1. Connect this AVADO

1. Click **Get a key**. Tailscale opens at **Settings → Keys**.
2. Click **Generate auth key**, switch on **Reusable**, and copy the key.
3. Back on the AVADO page, paste the key and click **Connect**.

Step 1 gets a tick with the name **avado**.

### 2. Approve its routes

This lets your devices reach the AVADO's network.

1. Click **Open Machines**. Tailscale opens its list of machines.
2. Find **avado** and choose **Edit route settings**.
3. Tick **172.33.0.0/16** and **Use as exit node**, then save.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fgit-blob-3f0c794d3cb144eb17ba24ab96f0809980cddf21%2Ftailscale-step-2-phone.png?alt=media" alt="Step 1 done, step 2 Approve its routes: at avado, choose Edit route settings, tick 172.33.0.0/16 and Use as exit node" width="300"><figcaption><p>Step 1 is done; step 2 tells you what to tick.</p></figcaption></figure>

{% hint style="info" %}
**Tip:** in **Machines**, open the menu next to **avado** and choose **Disable key expiry**. Otherwise Tailscale logs the AVADO out after a few months. The page reminds you of the date.
{% endhint %}

### 3. Add the AVADO as DNS

This makes the name **my.ava.do** work on your devices.

1. Click **Open DNS**. Tailscale opens its DNS page.
2. Choose **Add nameserver → Custom**, enter **172.33.1.2** (click it on the AVADO page to copy it) and save.
3. Turn on **Override DNS servers**.

{% hint style="info" %}
**Only for my.ava.do (split DNS):** if you'd rather not send all your devices' name lookups to the AVADO, skip **Override DNS servers**. Instead, when you add the nameserver, switch on **Restrict to domain** and enter **my.ava.do**. Your devices then keep their own DNS for everything else.
{% endhint %}

### 4. Connect your phone or laptop

1. Click **Get the app** and install **Tailscale** on your phone or laptop.
2. Log in with the **same** Tailscale account.
3. Press **Connect**.

### 5. Open my.ava.do

With Tailscale on, open <http://my.ava.do> on your phone or laptop. Your apps open at their usual addresses too.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fgit-blob-c5f48cd05e98469b84de36536af67c7596cd52c3%2Ftailscale-done-phone.png?alt=media" alt="All steps done: Tailscale is on. Open http://my.ava.do on your phone with Tailscale on" width="300"><figcaption><p>All five steps are ticked.</p></figcaption></figure>

## Everyday use

* Turn Tailscale **on** in the Tailscale app on your phone or laptop, then open <http://my.ava.do> or any app's address.
* At home you don't need it, but leaving it on does no harm.
* Want alerts and the Admin on your phone's home screen? See [Phone alerts and the home screen](https://docs.ava.do/your-avado/keep-your-avado-safe/phone-alerts-and-home-screen.md).

## More options (on the page)

* **Log in with a link instead of a key:** the page shows Tailscale's login link and a QR code. Only you should open it: whoever logs in adds your AVADO to their Tailscale.
* **AI Connect through Tailscale:** let ChatGPT or Claude on the web reach [AI Connect](https://docs.ava.do/private-ai/private-ai/ai-connect.md). Only AI Connect gets a public address. Your Admin and apps stay private.
* **Two AVADOs in one Tailscale account:** only one can be reached at a time. In **Machines**, untick the routes of the one you don't need from afar.
* **Log out of Tailscale:** removes this AVADO from your Tailscale. You can connect it again at any time.

{% hint style="warning" %}
**Who can reach your AVADO:** every device in your Tailscale account, the same as a device at home, including the AVADO's login. Add only your own devices, and don't share the AVADO with other people in Tailscale. If your box password is still the factory password `avado`, [change it](https://docs.ava.do/your-avado/keep-your-avado-safe/change-box-password.md).
{% endhint %}

## If something is wrong

* **Step 1 says the key was refused:** make a new **Reusable** key in Tailscale and paste it again. Or use **More options → Log in with a link instead of a key**.
* **my.ava.do does not open on your phone:** check that Tailscale is on, that step 2 (routes) and step 3 (DNS) have a tick, and that you logged in with the same account.
* **It worked for months, then stopped:** the AVADO's key expired. Log in again (step 1) and choose **Disable key expiry** in **Machines**.
* **On a Linux computer** nothing opens: Linux needs routes switched on in Tailscale. Ask support if you're not sure how.

Still stuck? Contact <support@ava.do>.
