Set Up & Use Dappnode

Warning

Do not start installing a HOPR node without a HOPR Safe. To create a HOPR Safe and run a node please follow the onboarding process here.

1. Install the HOPR Package

While connected to your Dappnode's network or via a VPN:

(1) Open the DAppStore using the sidebar to the left.

(2) Search for HOPR using the DAppStore search bar.

(3) You should see the latest version of the HOPR client in the listed dApps. Click the Get button under the HOPR package, this should take you to a new interface.

(4) Press install; this will open the setup wizard.

Note: Alternatively, click update if you have already installed the HOPR client.

(5) Copy your Safe address and Module address from your Staking Hub onboarding process.

Note: If you are re-installing an existing node and not onboarding, you can find the addresses within the dashboard.

With the setup wizard open, in parallel, go to the Staking Hub Dashboard.

From the dashboard, note your:

• Safe address
• Module address

(6) Find your home network's public IP address, you will need it. If you don't know how to find your IP address, follow the instructions here.

(7) Return to the setup wizard and fill out the Safe address, Module address, Public IP and RPC provider fields accordingly (the bottom three).

• Add your Safe address under the field: Staking safe address
• Add your Module address under the field: Staking safe module address
• Add your Public IP suffixed with the port :9091 under the field: Host IP/Port mapping
• Add custom RPC provider under the field: RPC Provider URL (to obtain the RPC provider URL, you can find guidelines here)

Note: Make sure to add the port suffix :9091 at the end of your IP address as shown in the image below.

Dynamic IP addresses will not work as once your IP address changes, your node will become unreachable. If you have a dynamic IP address, use a DDNS in place of your public IP address and enter it under the field Host IP/Port mapping, with the suffix :9091. You can view how to do this here.

(8) Now accept the disclaimer, and your HOPR package should start installing immediately. We recommend you enable auto-updates when prompted.

(9) Once installed, go to Packages and click on HOPR. Once inside the HOPR package, click on UI to enter the HOPR Admin UI.

(10) Click on the top right corner "Connect to node" and enter these details:

• API endpoint - http://node.hopr.public.dappnode:3001
• API token - If you haven't changed the security token during the installation process, the security token will be the default one: !5qxc9Lp1BE7IFQ-nrtttU.

After filling API endpoint & API token fields click on "Connect to the node".

(11) It will display an error message, indicating that you need to fund your node. Copy the Node address and return to Staking Hub to register on the waitlist.

Warning

Do not fund your node by sending funds from your wallet. Wait to complete the rest of the onboarding flow. You will be able to do this through the Staking Hub. Trying to fund the node directly may cause problems.

2. Link Your Node to Your Safe

info

Only do this if you have been approved to join the network. If you are still on the waitlist, please wait until you have been approved to join the network.

While connected to your Dappnode's network or via a VPN:

(1) Login to your Dappnode and go to Packages.

(2) Click on HOPR. Once inside the HOPR package, click on UI to enter the HOPR Admin UI.

(3) Scroll down until you see the section Addresses. Copy the Node address and return to the Staking Hub to complete the onboarding process.

3. Backup Your Identity File

Make sure to back up your identity file incase. This will help you restore your node in the future, if ever needed.

(1) Go to http://my.dappnode/packages/my/hopr.public.dappnode.eth/file-manager

(2) Under the Download file section, enter /app/hoprd-db/.hopr-identity and click Download.

(3) Unarchive the hopr-identity.tar file to see the .hopr-identity file.

Note: Make sure you are able to see hidden files. Adjust the settings on your device, otherwise the identity file will not be visible.

(4) Copy this file and save it somewhere safe.

Next Steps

Once you've completed the above steps, you should have a working HOPR node. You will then want to access the HOPR admin panel to interact with your node. You can read how to access and set up HOPR admin here.

Set Up Portforwarding

In order to run a HOPR node on the HOPR network you will need to have set up portforwarding, You can read up on why you need this and how to set it up here.

Restore an Old Node

You will need to use the file manager to restore an old node.

(1) Make sure you can view hidden files.

For Windows: Go to your File Manager app, and under View -> Show, make sure hidden files is ticked on.

For Mac: With the Finder app open, simultaneously press the key combination: Command + Shift + . ( Dot). You will need to do this during Step 2 on Mac.

(2) Find HOPR in your packages and navigate to the File Manager tab.

(3) In the text field under Upload file enter the path /app/hoprd-db.

(4) Then click the Browse button next to the Choose file field. And select your downloaded identity file.

Note: Select the file multiple times until it appears in the text field instead of the Choose File placeholder text.

(5) Finally, press the Upload button and wait for the upload to complete.

All done, you should now have restored your old node!

Restart Your Node

(1) Go to your HOPR package. You can access your packages using the sidebar on the left.

(2) Under the info tab, locate the section Status. It should show all containers running.

(3) On the right, press the Restart icon and wait for the package to restart.