Users usually need to connect to their DAppNode to do any kind of thing; such as download a DApp, update the system, create a new device, configure telegram, etc.
Ways to connect to your DAppNode
Currently, there are three ways to connect to your DAppNode:
WIFI hotspot (friendly UI): DAppNode devices can create wifi hotspots, so users can connect to their DAppNode via wifi, using their corresponding credentials. Users must be in the same network as the DAppNode.
VPN (friendly UI): for those users who want to connect to their DAppNode being in a different network, they can use VPN. There are some peculiarities with the VPN service that will be covered in this post. VPN connects to the DAppNode UI provided by your DAppNode. More info in the docs.
SSH (not-friendly UI): the ssh method is something that only advanced users may use. SSH is usually used to fix problems in the host machine. It gives you a terminal to interact with your DAppNode.
To be able to use VPN there are a few requirements that must be set:
- UPnP enabled: UPnP is a network protocol most router has available. If you do not know how to enable it, check this guide.
Ports opened: UPnP shoul have opened the following ports
- 8092 TCP: port used to correctly download the OVPN file.
- 1194 UDP: default port to connect via OpenVPN.
- One device per VPN credentials: Only one device can access your DAppNode for each VPN credentials created
Double-check UPnP is enabled
Having DAppNode installed, you can connect to your DAppNode following this guide.
As a brief summary, the steps can be summarized into:
- Install open VPN client
Get QR code/URL: from this link you can download the VPN file for your device
2.1 DAppNode startup: DAppNode displays the link to download just after installation.
dappnode_connect: this command generates a new link to download the VPN file.
2.3 In the UI: go to devices > Add device > Get link
- Connect to your DAppNode using the VPN file downloaded.
VPN common problems
The most common issues to connect to your DAppNode VPN are related to port forwarding or issues with your specific internet provider and router configuration. We have documented known cases in the DAppNodeDocs/troubleshooting.
Note that your particular network configuration could be new to the community and your error unique. Please be mindful that your error might not be documented and if so, please document it so future users can share your solution.
My problem is not documented
- Check if your router supports UPnP
- Access router config
1.1 Verify UPnP enabled
1.2 Verify ports 8092 and 1194 are opened
- Make sure your DAppNode is running properly
- Create a new VPN link and try again
- Try to connect from another network if possible
VPN, how does it work?
- secure eth traffic
- secure connectiviy
In the following picture is described the process of how DAppNode VPN is configured: router route table and DynDNS registration.
DAppNode first setup: having a DAppNode connected to a router with UPnP enabled, will generate a routing table in the router. This route table will point from specifics ports (such as 1194, 8092) to the local IP of your DAppNode.
If the local IP of your DAppNode changes, it may take up to one hour for the routing table to be updated
DAppNode ID registration: Then your DAppNode will attempt to reach the DynDNS server (orange arrow) provided by DAppNode with:
- DAppNode ID: 45dgh34
- Public IP: 126.96.36.199
- DAppNode registration: the DynDNS will register your DAppNode ID as well as the public IP in a database (blue arrow). Whenever the public IP of your DAppNode changes, the public IP in the database will be refreshed.
Connect to DAppNode
In the following picture is described the connection process via VPN.
- Reach public IP: having a user the VPN file (which is like an instructions map), the user would be able to connect to his/her DAppNode from everywhere. First by reaching the public IP of the network where the DAppNode is hosted (red arrow).
- Reach DAppNode local IP: once the public IP has been reached, the router will use the routing table (relation between ports and local IPs) to redirect to the DAppNode in the local network.