# Remote Connect

## What is Remote Connect? <a href="#what-is-remote-connect" id="what-is-remote-connect"></a>

Remote Connect is a package that allows remote connections to your Avado machine from anywhere in the world on almost any device.

* Want to check your Avado machine on your iPhone while taking a walk? Remote Connect ✅
* Want to update a package using your laptop while waiting for a flight? Remote Connect ✅
* Want to isolate your Avado machine on its own network but still access it? Remote Connect ✅

The Remote Connect solution is super easy and works in nearly every environment. No need to open any ports on your router or fiddle with config files etc. It works from both your home WiFi and from anywhere in the world with just one configuration.

So let’s get it set up!

{% hint style="info" %}

### Troubleshooting

If you have any problems along the way (e.g. the connection isn't working) check out these troubleshooting steps to solve common problems like VPNs on Mac blocking the connection, and more! <https://wiki.ava.do/troubleshooting/connection-troubleshooting>
{% endhint %}

### Step 0: Update your AVADO <a href="#step-0--update-your-avado" id="step-0--update-your-avado"></a>

This tutorial assumes that your Avado machine is up to date with all the latest package versions. Go to <https://ava.do/start> to make sure your Avado is up to date.

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

The package should come pre-installed on your machine, but if not, you can find the “Remote Connect” package in the [DappStore](http://my.ava.do/#/installer).

* In the DappStore, the package name is “Remote Connect”.
* Once installed the system name is “remoteconnect.avado.dnp.dappnode.eth”.

Press the install button and let it finish.

### Step 2: Download a client for connecting <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:

* [Windows](https://download.zerotier.com/RELEASES/1.6.6/dist/ZeroTier%20One.msi)
* [MacOS](https://download.zerotier.com/RELEASES/1.6.6/dist/ZeroTier%20One.pkg)
* [Android](https://play.google.com/store/apps/details?id=com.zerotier.one)
* [iOS](https://itunes.apple.com/us/app/zerotier-one/id1084101492?mt=8)

### Step 3: Go to the configuration wizard <a href="#step-3--go-to-the-configuration-wizard" id="step-3--go-to-the-configuration-wizard"></a>

Navigate to the "Remote Connect" menu:

![](https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FGlFbghmSGOs9vOFMR2TX%2Fimage.png?alt=media\&token=7f5ec179-612d-4def-a5e8-fde2d24eba71)

Or go directly to the package: <http://my.ava.do/#/Packages/remoteconnect.avado.dnp.dappnode.eth>

You will see your unique network ID - and a default network name.

![](https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FwR3FPid2jFlL5S1OEZBS%2Fimage.png?alt=media\&token=f13e2547-32e2-4545-b2ab-12f497703534)

{% hint style="info" %}
You can click the name to rename your Avado network so you can recognize it in case you have multiple machines.
{% endhint %}

### Step 4: Join your personal Avado network with your client <a href="#step-4--join-your-personal-avado-network-with-your-client" id="step-4--join-your-personal-avado-network-with-your-client"></a>

The next step is to paste this network ID into your client.

{% tabs %}
{% tab title="MacOS" %}
You will find an icon in the top bar of your desktop - Click on the icon to open the configuration menu.

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2F4GB3JMctRig6W9xe977T%2Fimage.png?alt=media&#x26;token=c2a4d300-234a-4f49-829f-44d745543d0e" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Make sure to check the **Allow Global** and **Allow DNS** checkboxes.
{% endhint %}

Enter the Network ID from your Avado and press **Join**.

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FeTMwWMW2CMK3FtjJG5Bh%2Fimage.png?alt=media&#x26;token=cb38ef26-7592-4f42-838a-9e2423bfa2ee" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

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

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FD1sZHDvURtr5BA3TRlL2%2Fimage.png?alt=media&#x26;token=80706b43-4c6d-4be6-9a8b-d65d49cb87e2" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Make sure to check the **Allow Global** and **Allow DNS** checkboxes.
{% endhint %}

Enter the Network ID from your Avado and press **Join**.

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FcFvqOBvDYcC9q5hfWftR%2Fimage.png?alt=media&#x26;token=c8235558-73ed-4ad8-ba69-9b37dad5cd1a" alt="" width="524"><figcaption></figcaption></figure>

{% endtab %}

{% tab title="IOS" %}
Install the **ZeroTier One** app from the AppStore and add a new network (press the + icon in the top right, then scroll to the bottom and accept the terms and conditions).

Enter the network ID from your Avado machine:

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FNd6fWVRyeuRt1INQ7cQ9%2Fimage.png?alt=media&#x26;token=7843f182-ac98-4b00-aca0-503cd16ac7c4" alt="" width="375"><figcaption></figcaption></figure>

When the network has been added, on the home screen of the app, make sure that the connection is on.

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FgmRi73iSwcz8ZN82iLEc%2Fimage.png?alt=media&#x26;token=55a3c603-599e-4563-9429-f185550a0261" alt="" width="375"><figcaption></figcaption></figure>

Press on the name of your device (e.g. Avado Home) to bring up the config information. In the screenshot below it says the status is "OK" but you won't see that just yet, as you first need to allow the new device from the Avado machine.

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2F1Qq5SidjC696sbi1vlKB%2Fimage.png?alt=media&#x26;token=2d44b176-eb99-48cd-b48b-9c8b9d8d9ab1" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Android" %}
Install the ZeroTier One app from the Google Play Store. Once opened, click on the + to join a network. Input your Avado network ID at the top and select Network DNS. Then click at the bottom to add network. Make sure you enable the connection in the remote connection 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 tha Avado dashboard at my.ava.do.

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2Fev0f1vC2WoJGVCyouTVx%2Fimage.png?alt=media&#x26;token=cb2647ec-4fe4-458b-b8de-a6072b266a69" alt="" width="188"><figcaption></figcaption></figure>

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2Fy7NrkGgXIuUg60o59TOy%2Fimage.png?alt=media&#x26;token=25696120-62a9-414f-9bfe-3c4c79bc505b" alt="" width="188"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 5: Enable client access on the Avado machine <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 machine. After a few seconds, you will see the new client automatically appear in the network member list.\\

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FJmVilWyy7ojLGmQUQVG5%2Fimage.png?alt=media&#x26;token=9702fc18-c80e-467a-b063-47e26330190c" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
You can click the Description to rename your device to a name that you can easily remember the device that you gave access.
{% endhint %}

<figure><img src="https://1029745181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG3Lk76lfvw9ecPIg0mK8%2Fuploads%2FWam1SR9S3p51sqUNHU4V%2Fimage.png?alt=media&#x26;token=c861eac6-1c08-474a-90aa-4efb6fb982a7" alt=""><figcaption></figcaption></figure>

### Step 6: Switch back to your home WiFi <a href="#step-6--switch-back-to-your-home-wifi" id="step-6--switch-back-to-your-home-wifi"></a>

Before trying it out:

* If you are connected through the Avado VPN: **Disconnect from the VPN**
* If you are connected through the Avado WiFi: **Switch back to your home WiFi**

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

After you disconnected from the Avado VPN and/or switched back to your home Wifi - now it’s time to connect your device to the Avado network.

Click on the connection so that it has a checkmark in front of it. If you click on **Network Details** you should see “OK” next to the status.

{% hint style="info" %}
If you see **REQUESTING\_CONFIGURATION** please give it a minute or 2 to switch to **OK**.
{% endhint %}

{% hint style="info" %}
If you are using the Remote Connect method - please use the URL [http://my.ava.do](http://my.ava.do/) instead of the old <http://my.avado/> since the old URL will not work on this connection.
{% endhint %}

### Step 8: Disconnect and reconnect

From the client - you can turn off the active connection by clicking the selected network, the checkmark will disappear and you are disconnected. To reconnect later - just click the network again. When the checkmark is present you are connected again!

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.
