Skip to main content

Troubleshooting

Help! I can't access my Dappnode!
If it is your first time trying to access your Dappnode, please try one of the following steps:

  • If you are connected to the same network as your Dappnode via wired Ethernet, try to access the UI using the address http://dappnode.local
  • If you've bought a Dappnode or installed it on a machine with integrated Wi-Fi, try to access the Wi-Fi hotspot 'DAppNodeWifi'.

If all of the above does not work, visit our Discord and ask for help in the #support channel.

Why can't I connect to my Dappnode via VPN?
If you have set up OpenVPN and you cant access your Dappnode, remember that you might need to set up port forwarding on your router. Sometimes the feature called 'UPnP' enables these ports on your router automatically but this sometimes does not work or is not available on your router.

To do this, you need to access your router configuration and "port-forward" the following ports: TCP Port 8092 and UDP Port 1194.


In case you have set up WireGuard, you might need to "port-forward" the following port: 51820

Once you have done that AND you still can not access your Dappnode, you might have to create two profiles:

  • A Local profile: This profile is used when you are connecting from within the same network that the Dappnode resides in.
  • A Remote profile: This profile is used when you are connecting from a different network than the one where your Dappnode resides in.
When you create the VPN profiles, there is a link that generates that toggles config creation for either local or remote usage.

You can also check out our guides on how to configure VPN access here.

Can I recover a lost admin password?
You can not outright recover your admin password but you can regain access to your Dappnode if you wrote down the recovery token provided during the initial setup.

More about the initial setup can be found here

How do I recover a lost admin password using my recovery token?
Visit the login page of your Dappnode:

You will then see the option 'Forgot password?' underneath the 'Login' button. Once you click that, a new input field will appear where you can input your recovery token. We will use 4LMB9w3l50Yljwr6bIgQ in this example.

If you have entered the correct recovery token, you'll then be prompted to enter a new admin password.

Once you've filled out those fields and pressed 'Register', your Dappnode will once again provide you a recovery token. Do not forget to write down and save this one!

What do I do if I lost the password AND my token?!
In the case where you have lost both the password and the recovery token, you will need either SSH or local access to the Dappnode machine.

Once you are connected to your Dappnode, type the following command which prints the recovery token to the terminal:
cat /usr/src/dappnode/DNCORE/admin-recovery-token.txt ; echo

The command does the following:

  • Reads the admin-recover-token.txt file where the token is saved.
  • The ; echo is used to make it easier to read and copy the token.

After inserting the command above, you can obtain the recovery token and use that one to recover your admin access.

In the section above ('"How do I recover a lost admin password using my recovery token?') you can check out how to use your token to regain access.

How do I force update my Dappnode without losing data?
If you are experiencing an issue or just want to make sure you are running the latest Dappnode version, execute this command below in the Dappnode terminal.

This will update the core packages to the latest versions without erasing any data from your Dappnode.

⚠️ This will clear any EXTRA_OPTS fields, but no chain data, keys, or other configurations will be affected ⚠️

sudo wget -O - https://installer.dappnode.io | sudo UPDATE=true bash`