# Set up Remote Connect + ZeroTier

## Quick Setup

(These are the high-level steps to set up Remote Connect + ZeroTier, for quick reference.  Please refer to the sections below for more details of each step.)

Make sure you're connected to the AVADO Wi-Fi network, then go through the following steps.  

1. Install the “Remote Connect” package on the AVADO machine, if it's not already installed.
2. Obtain a unique 16-letter **Network ID** for your AVADO machine.
3. Install the “ZeroTier One” app on your device(s).  Each device will receive a distinct 10-letter **Node ID**.
4. From your device(s), “Join” your personal AVADO network using its unique Network ID.  Make sure that you choose exactly the following options:
   * On desktop devices (Windows, Mac), choose **Allow Managed**, **Allow DNS**, and **Allow Global**, but **do not choose** "Allow Default";
   * On mobile devices (Android, iOS), choose **Network DNS**.
5. On the AVADO machine, “Allow” your device(s) to join.
6. Disconnect your device from AVADO Wi-Fi and connect normally to Home Wi-Fi.  Navigate to the Home Page at <http://my.ava.do>

You have now established a secure, end-to-end connection between your device and the AVADO.  Going forward, you can access the AVADO via the ZeroTier connection.

The following guide provides more details on each step.

{% hint style="warning" %}
The former OpenVPN access has been deprecated.  The recommend means of connection is Remote Connect + ZeroTier.
{% endhint %}

## What is it?

The **Remote Connect** package, combined with the **ZeroTier** app on your devices, allows you to establish a seamless connection between your computing devices and the AVADO machine, whether you're at home or elsewhere.  It is a powerful tool that enables you to connect from virtually anywhere without the need to tweak any settings.

At home, you can always connect to the AVADO through ZeroTier:&#x20;

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FYWFm3NiqOFECjftumE7V%2Fconnect-local.png?alt=media&#x26;token=7c4017b4-9e43-40d9-b6fd-f660a11fd2db" alt=""><figcaption><p>Connecting to your AVADO at home on the local network</p></figcaption></figure>

From anywhere else, you can connect to your AVADO remotely and securely, without changing any settings:

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2F27k0UU0n9giETMvDNMvG%2Fconnect-remote.png?alt=media&#x26;token=e2947685-2a69-4f0d-b2fd-b92e4f2ef0e2" alt=""><figcaption><p>Connecting to your AVADO when you're away from home</p></figcaption></figure>

### What about the AVADO Wi-Fi?

The AVADO Wi-Fi serves as an onboarding tool for new users to set up their devices and create the Remote Connect + ZeroTier connection.  However, it does not provide sufficient bandwidth for all traffic to pass through it.  We recommend using the AVADO Wi-Fi solely as a backup access method once you have set up Remote Connect + ZeroTier.

For security reasons, it is advisable to detach the antennae from the i7 devices after the setup process. For r9 devices with built-in antennae, we suggest changing the password.  Please see: [Help with Wi-Fi Password](https://docs.ava.do/quick-help/help-with-wi-fi-password).

## Before you start

1. **Disable any VPN software** you might have running on your computer (like NordVPN).  Even if you don’t have an active connection, the software might still interfere with your connection to the AVADO.  If everything else fails, uninstall your VPN software to rule this out. &#x20;
2. Mac and iOS users: if you have an iCloud+ subscription, be sure to turn off iCloud Private Relay.
3. Make sure your AVADO is up to date.  Go to <https://ava.do/start> and let the machine download the latest packages.

## Step 1: Install Remote Connect <a href="#step-1--install-package" id="step-1--install-package"></a>

Your AVADO may come with Remote Connect pre-installed.  Check on the left-side menu on the Home Page to see if the **Remote Connect** item is already available.  If not, follow the following steps:

* While connecting on AVADO Wi-Fi, go to the AVADO Home Page (<http://my.ava.do>) and navigate to **DappStore**.
* Scroll to the “AVADO System” section near the bottom of the page. Locate the “Remote Access” package. Click the icon, then press the **Install** button.
* Once finished installing, a **Remote Connect** item shall appear on the left-side menu on the Home Page.

## Step 2: Obtain Your Unique Network ID <a href="#step-3--go-to-the-configuration-wizard" id="step-3--go-to-the-configuration-wizard"></a>

Click the **Remote Connect** menu item, or equivalently, navigate to <http://my.ava.do/#/Packages/remoteconnect.avado.dnp.dappnode.eth>

You will see your unique network ID, and a default network name.  Use the icon next to the AVADO Network ID to copy it to your clipboard.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FF0097pR7mlDZ4pIzqLJt%2Fx-connect-ZT-id.png?alt=media&#x26;token=f36cd96a-2ba9-4d66-be36-ec4f96b8f2a2" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
You can click the **Name** to rename your AVADO’s network so you can recognize it in case you have multiple AVADO’s.
{% endhint %}

## Step 3: Install ZeroTier App on your Device <a href="#step-2--download-a-client-for-connecting" id="step-2--download-a-client-for-connecting"></a>

Meanwhile - you can download the remote connect client for your device and install it.  Visit the ZeroTier [download](https://www.zerotier.com/download/) page, or use the following links:

* [Windows](https://download.zerotier.com/dist/ZeroTier%20One.msi) - follow the Installer prompts to complete the installation
* [MacOS](https://download.zerotier.com/dist/ZeroTier%20One.pkg) - click open the app package, and drag the ZeroTier One app to the Applications folder
* [Android](https://play.google.com/store/apps/details?id=com.zerotier.one)
* [iOS](https://apps.apple.com/us/app/zerotier-one/id1084101492)

## Step 4: Join your Personal AVADO Network from your Device <a href="#step-4--join-your-personal-avado-network-with-your-client" id="step-4--join-your-personal-avado-network-with-your-client"></a>

Next step is to connect from your device to the AVADO, using its unique Network ID you obtained in Step 2.  Click the tabs below to reveal instructions for Windows, Mac, Android, or iOS, respectively.

{% tabs %}
{% tab title="Windows" %}
Click the orange ZeroTier icon to get the pop-up menu and select **Join Network.**

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FmQriS7GkFgczKSijzppa%2Fx-connect-ZT-win-join1.png?alt=media&#x26;token=62ff5918-f1de-4bbd-af38-b8d59b2baf35" alt="" width="375"><figcaption></figcaption></figure>

Enter or paste the 16-letter Network ID of your AVADO.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FgJLFm2TcsyzUzTTXmtLQ%2Fx-connect-ZT-win-join2.png?alt=media&#x26;token=a0533849-1fdc-4934-8439-fe46e6c79db3" alt="" width="524"><figcaption></figcaption></figure>

Make sure to check the **Allow Managed**, **Allow Global** and **Allow DNS** checkboxes or things will not work.  Do not allow "Default".  Press **Join** to set up the connection.
{% endtab %}

{% tab title="Mac" %}
Launch the ZeroTier One app from Launchpad, or click on the ZeroTier One icon in the top bar of your desktop to open the configuration menu.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FCjRJ7guGIt7WmxZ19xRx%2Fx-connect-ZT-macos-join1.png?alt=media&#x26;token=b6a802bc-162a-4823-a863-188f3207daff" alt="" width="563"><figcaption></figcaption></figure>

Enter or paste the 16-letter Network ID of your AVADO. &#x20;

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FhfB4o01ykGJMj1E9xedp%2Fx-connect-ZT-macos-join2.png?alt=media&#x26;token=afe2129d-7d1e-462e-9ff9-486f5df14456" alt="" width="563"><figcaption></figcaption></figure>

Make sure to check the **Allow Managed**, **Allow Global** and **Allow DNS** checkboxes or things will not work.  Do not allow "Default Route".  Press **Join** to set up the connection.
{% endtab %}

{% tab title="Android" %}
Install the ZeroTier One app from the Google Play Store.  Once opened, click on the `+` to join a network.  Input or paste your 16-letter Avado Network ID at the top and select **Network DNS**.  Do not select "Enable Default Route" or "Enable On Demand". &#x20;

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FRQiegsSGXFY0FtrsprbB%2Fx-connect-ZT-android1.jpeg?alt=media&#x26;token=048cee7f-19ca-4b09-9a0b-7a21a2ed7770" alt="" width="375"><figcaption></figcaption></figure>

Then click at the bottom to **Add Network**.&#x20;

Make sure you enable the connection in the Remote Connect package on the AVADO as described in Step 5.  Then just click on the slider in the app to connect to your AVADO and use your browser to confirm that you can access the AVADO dashboard at <http://my.ava.do>

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FdlaFPBXxdQcFRuge1rcs%2Fx-connect-ZT-android2.jpeg?alt=media&#x26;token=7be5d69c-ca82-4c41-a930-ed6ca644e20d" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="iOS" %}
Install the ZeroTier One app from the App Store.  Once opened, click on the `+` to join a network.  Input or paste your 16-letter Avado Network ID at the top and select **Network DNS**.  Do not select "Enable Default Route" or "Enable On Demand". &#x20;

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FUrp9BIROOdc87Syw0Bfv%2Fconnect-ZT-iOS1.PNG?alt=media&#x26;token=0a1250c9-d14f-473e-a910-f61354dfa4fc" alt="" width="375"><figcaption></figcaption></figure>

Then click **Add Network**.&#x20;

Make sure you enable the connection in the Remote Connect package on the AVADO as described in Step 5.  Then just click on the slider in the app to connect to your AVADO and use your browser to confirm that you can access the AVADO dashboard at <http://my.ava.do>

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2Fi8DKpJfUdlbjYpzWX7FT%2Fconnect-ZT-iOS2.jpeg?alt=media&#x26;token=4d5e6cfd-9c8f-4070-ace3-2bf0bf835aaf" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Step 5: Allow your Device to Join on the AVADO <a href="#step-5--enable-client-access-on-the-avado" id="step-5--enable-client-access-on-the-avado"></a>

Go back to your AVADO.  After a few seconds you will see the new device automatically appear in the **Network Member** list.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FCp1DInNSxKA5m9EtQvuR%2Fx-connect-ZT-device-shows-up.png?alt=media&#x26;token=756ede02-f475-4f7f-8141-5c96504839fe" alt="" width="563"><figcaption></figcaption></figure>

The only thing you need to do now is check the box to enable access to this client.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FlX3Yc3cseawNpQLMQ5py%2Fx-connect-ZT-enable-and-rename.png?alt=media&#x26;token=ea2b73a8-824d-4238-9b4d-4ca0c8263639" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
You can click on the **Description** to rename your device so you can easily recognize the device that you gave access to.
{% endhint %}

## Step 6: Connect Through Remote Connect + ZeroTier <a href="#step-7--connect-through-the-remote-connect-client" id="step-7--connect-through-the-remote-connect-client"></a>

**Disconnect** your device from the AVADO Wi-Fi, and switch back to your **Home Wi-Fi** network.&#x20;

On Windows or Mac, click on the Network ID so that it has a checkmark in front of it.  If you click on **Network Details** you should see “OK” next to the status.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FZTPrK4jRDrcoNdZFjxjA%2Fx-connect-ZT-status-ok.png?alt=media&#x26;token=47291b3d-bd8a-4b33-9202-04455c7e9a11" alt="" width="563"><figcaption></figcaption></figure>

On Android or iOS, click on the slider button next to the Network ID. &#x20;

If you see **REQUESTING\_CONFIGURATION** please give it a minute or two to switch to “OK”.

On your browser, navigate to <http://my.ava.do/> to go to the AVADO Home screen.

You can use this connection from within your own network, or from anywhere in the world.  All traffic over this connection is peer-to-peer and is fully encrypted.

## Step 7: Disconnect <a href="#step-7--disconnect-and-reconnect" id="step-7--disconnect-and-reconnect"></a>

You can safely leave the ZeroTier connection on all the time, so you can visit the AVADO Home page any time you need to.

To disconnect, on Windows or Mac, click on the Network ID from the ZeroTier dropdown menu.  The checkmark will disappear and you are disconnected.  On Android or iOS, click on the slider button to turn it off.

<figure><img src="https://2996176873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0YTdumceG05uJMtaEgaT%2Fuploads%2FtqD46G6EtLPr9XYqz0sx%2Fx-connect-ZT-disconnect.png?alt=media&#x26;token=835aba6b-6071-4985-bdd9-d72ee00d8aac" alt="" width="504"><figcaption></figcaption></figure>

To reconnect, just open the app and select the network again.  When the checkmark is present you are connected again.&#x20;

## Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

If you encounter any problem, please consult the [Connection Troubleshooting](https://docs.ava.do/quick-help/connection-troubleshooting) page, or reach out to our [Discord](https://docs.ava.do/your-avado/avado-support-community) channel for support.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ava.do/your-avado/connecting-to-your-avado/set-up-remote-connect-+-zerotier.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.