Connection Troubleshooting

Common Connection Issues and Solutions

Check Internet / Router Connection

Perform the following troubleshooting steps to ensure that your AVADO is properly connected to your router and to the internet.

👉 Check your internet connection

Ensure that your AVADO device is connected to a stable and reliable internet connection. Verify that other devices are able to connect to the internet without any issues.

👉 Check if the network lights are on and blinking

Make sure that the network lights are ON and blinking on the AVADO. The network lights are the orange and green LED’s next to the network plug on the AVADO device. Usually one of the two blinks while the other is on permanently.

If this is not the case either plug your AVADO into another port of your router or try with another network cable.

👉 Change router port

If any reconfiguration on the router has been done, it sometimes helps to plug in the network cable into a different free network port on your router. This will trigger the router and the AVADO to re-negotiate their network connection and might solve connectivity issues.

👉 Swap the network cable

Swapping out the network cable for another one also has been reported to help in the rare case that you have a faulty cable.

Disable VPN Software

Disable any VPN and VPN-like software you might have running on your computer. Examples are: NordVPN, iCloud Private Relay (for Mac and iOS), or Cloudflare's 1.1.1.1 with WARP service.

Even if you don’t have an active connection, the software might still interfere with your Wi-Fi or remote connection software to the AVADO.

If everything else fails, uninstall your VPN software to rule this out.

No Wi-Fi Signal

If you cannot see the AVADO SSID at all, it is possible that the AVADO Wi-Fi is not functioning, or the AVADO has not started properly. Follow the following steps.

👉 Check internet / router connection

Note that the AVADO Wi-Fi won't start without an internet connection. See here first.

👉 Check the antennae

For the i7 model with external antennae, check that they are securely screwed on.

👉 Check with another device

Do you have another device (computer / tablet / phone) handy? Try to see if you can detect the AVADO Wi-Fi from another device.

👉 Restart the router

Try restarting your router by unplugging it and waiting 15 seconds and then plugging it back in. Wait for it to restore your internet connection. Then check to see if you have the AVADO Wi-Fi signal.

👉 Restart the AVADO

Sometimes the device may have "hung up", or there may be other issues that prevent it from proper functioning.

Try a hard reboot: Press the power button for a few seconds until the blue light goes out. Use the power button for this purpose. Avoid pulling out the plug or otherwise cut the electricity supply to the device, to avoid hardware damage.

Wait a few seconds, then press the power button again to restart the device. Check the network connectivity again.

👉 Check for hardware fault

Attach an HDMI monitor and a USB keyboard to the AVADO to check for hardware fault.

This is useful as a diagnostic tool to confirm or rule out a hardware fault. Find a screen with HDMI input (tip: use your TV if you don’t have a monitor) and attach an HDMI cable to your AVADO. Get a USB keyboard and attach it to any of the USB ports of your AVADO. Make sure your AVADO is connected to the internet before proceeding.

If your AVADO is functioning normally, you should see a login prompt displayed on the screen. The prompt will look like this:

AVADO login: _

There should be no other error messages displayed.

However, if there is a hardware fault, such as a failed SSD drive, you may encounter multiple error messages or the device may get stuck at the boot screen.

If unfortunately this happens, raise a ticket at AVADO Discord for support.

👉 Reset the BIOS

Often there can be small issues caused by actions made since the factory install. By resetting the BIOS it restores the AVADO to the default factory settings that were designed for everything to function optimally. It can often be all that is needed to resolve a problem.

See: Resetting your BIOS

Wi-Fi connected, but stuck on the loading screen

In some cases, you may experience a situation where the AVADO Wi-Fi appears to be connected, but the device gets stuck on a "loading" screen without making any progress. Here are some examples:

Here are some possible steps to address this issue:

👉 Check internet / router connection

Ensure that your AVADO device is connected to a stable and reliable internet connection. Verify that other devices are able to connect to the internet without any issues. Go through the checklist here.

👉 Disable VPN Software

Make sure you do not have any VPN or VPN-like software running on your computer, such as NordVPN, or iCloud Private Relay (for Mac and iOS). See here.

👉 Check with another device

Do you have another device (computer / tablet / phone) handy? Try to see if you can connect from another device.

👉 Check the wi-fi network settings on your device

The AVADO Wi-Fi connects to a local network with IP addresses that start with 172.33.12.xxx. You can verify if this is correct on your device. The following screenshots are taken from the Mac; it should work similarly on Windows.

You should see the Wi-Fi connection to the AVADO network (in this screenshot it is renamed to AVADO-i5 - yours will be called AVADO by default)

Then click on the Advanced button and verify if you have an IPv4 Address that is in the range 172.22.12.xxx

Then go to the DNS tab and verify if you have exactly this setting. There should be only one DNS server and it should be 172.33.1.2

If all that is the case you should be able to access the http://my.ava.do/ URL that leads you to the AVADO admin page.

Cannot connect via ZeroTier

Assuming you have already set up the Remote Connect package on your AVADO device and have installed the ZeroTier app on your computer, tablet, or phone, you may encounter an issue where you are unable to establish a connection via ZeroTier. If you find that you are stuck at a status of "REQUESTING_CONFIGURATION", it indicates a problem with the ZeroTier connection.

👉 Connect to your Home Wi-Fi, not AVADO Wi-Fi

Make sure you are connecting to your Home Wi-Fi, not the AVADO Wi-Fi, when you are trying to connect using Remote Connect + ZeroTier.

👉 Disable VPN software

Make sure you do not have any VPN or VPN-like software running on your computer, such as NordVPN, or iCloud Private Relay (for Mac and iOS). See here.

👉 Check that you've set up Remote Connect and ZeroTier correctly

Did you follow exactly the steps outlined in Set up Remote Connect + ZeroTier section?

In particular, verify the following:

You have checked the correct options in the ZeroTier app:
- Allow Managed
- Allow Global
- Allow DNS
- Not allow Default Route
If using the phone app (iOS or Android), be sure to select Network DNS when joining the network.
You have "allowed" your device on the AVADO side. If you have not "allowed" your device, the ZeroTier status will show ACCESS_DENIED.

The connection will not work if any of these settings are incorrect.

👉 Check with another device

Do you have another device (computer / tablet / phone) handy? Try to see if you can connect from another device.

👉 Restart the ZeroTier Client

Close the ZeroTier app on your device and restart it. This can help refresh the connection and resolve any temporary issues.

👉 Restart the Remote Connect package

Try restarting the Remote Connect package on AVADO. This requires you to connect via the AVADO Wi-Fi, or "secure shell" (for advanced users).

To restart the Remote Connect package via AVADO Wi-Fi:

Make sure you are not using any VPN software on your device.
Connect to AVADO Wi-Fi.
Go to the Home Page: http://my.ava.do
Navigate to the System menu
Locate the Remote Access, or "remoteconnect.avado.dnp.dappnode.eth" package
Open the package, and click Restart

Wait a few seconds for the package to restart. Then disconnect from AVADO Wi-Fi, connect back to your Home Wi-Fi. Try to connect via the ZeroTier app again.

For advanced users:

Find out your AVADO’s IP address on the internal network. You may need to check this at your router. It should look like 192.168.0.xx
Open a terminal window on your device. For Mac, this is the Terminal app. For Windows, use the CMD tool.
Type the following command:

ssh avado@192.168.0.xx 'docker restart $(docker ps -q --filter name=remote)'

Replace the 192.168.0.xx with your AVADO internal IP. Make sure you type (or copy) exactly on a single line. Note the spaces, single and double minus signs, and single quotes. Use all small letters. Then press return.

When asked for a password, type avado (in small letters) and press return.

This should restart your remote connect package on the AVADO. You can then try the ZeroTier connection again and see if it works.

Wi-Fi / ZeroTier connected, but cannot reach Home Page

There can be different scenarios where the Wi-Fi or ZeroTier connection appears to be connected, but you are unable to reach the Home Page. These situations might manifest through various symptoms, such as:

An error message that says: Your AVADO connection needs troubleshooting!
An error message that says: Could not connect to AVADO
Site cannot be reached, page not found, or connection timeout
Endless loading
Blank page

👉 Reload page

Try to reload the page, using a function in your browser such as: reload page, refresh page, reload from source, open page in new frame, and similar.

👉 Clear the browser cache

Sometimes, cached data can interfere with accessing web pages. Clear your browser cache and try accessing the Home Page again.

👉 Use incognito mode

If even clearing the browser cache does not help, try Incognito Mode (Chrome), or Private Browsing (Safari), or similar on your browser.

👉 Try a different browser

If you are experiencing issues with one browser, try accessing the Home Page using a different browser to see if the problem persists.

👉 Try another device

Do you have another device (computer / tablet / phone) handy? Try to see if you can connect from another device.

👉 Disconnect, then reconnect

Disconnect from the Wi-Fi or ZeroTier connection, wait a few seconds, then try to reconnect again. This may sometimes restore the connection.

👉 Disable VPN Software

Make sure you do not have any VPN or VPN-like software running on your computer, such as NordVPN, or iCloud Private Relay (for Mac and iOS). See here.