To use the HOPR network, you will need to create a
HOPR Safe and install a
hoprd node. There are two methods for installing a
hoprd node, but before doing so, please read this page to ensure you are familiar with our waitlist policies and any prerequisites for running a node.
It is not possible to run a node without a
You will need a HOPR Safe to securely store your funds while operating a
hoprd node. To create a HOPR Safe and run a node please follow the onboarding process here.
The Dufour release is currently permissioned. You will only be able to interact with other nodes once you have been added to the network by the HOPR association. This will likely take 1-2 weeks but may vary depending on your stake and whether or not you have a Network Registry NFT. You can find the additional details for this process here.
The minimum requirements for running
hoprd on your device:
- Dual Core CPU ~ 2 GHz
- 4 GB RAM
- at least 3 GB Disk Space
Although it is recommended that you have at least 8 GB of RAM and 10 GB of disk space.
For VPS/Windows Users
Using a VPS is recommended if you are on Windows, as all the instructions for installing your node are for Linux/macOS users. A VPS, in general, is an ideal setup as your node is constantly running in the background without needing your machine to be plugged in or turned on.
If you intend to run your node locally, try and use a setup where your PC or machine can stay plugged in throughout the day. Otherwise, you can use a plug-n-play device such as Dappnode, which you can plug in and forget about.
Avado is no longer supported with the release of Dufour. Any software found on the Avado store is outdated and will not allow you to interact with anyone within the Dufour network. If you have an Avado device, it is strongly recommended you migrate its operating system to DappnodeOS. You can do so using the guide here.
For the Dufour release, every node must have port forwarding set up in order to be visible to other nodes on the network. You can read all about it here.
How To Test Port Forwarding Is Setup For My Node
To verify if you have correctly port forwarded the ports, follow these steps to check if the port to your HOPRd node is open from outside your network.
You can view a complete walkthrough of the onboarding process in the video below, but please note:
- The video shows a VPS/Docker installation method and not Dappnode.
- The video does not show the node being restarted after the waitlist step. You will need to make sure you do this, as is recommended in the docs for Docker.
- The video does not mention port forwarding, but you will need to set this up in order for your node to be reachable by others on the network. You can read more about this here.
configure nodestep has been replaced by
configure module, so you will have to sign a couple more transactions during that step than what is shown in the video.
hoprd installation methods
We support two distribution mechanisms to install
A Dappnode plug-n-play device, another quick setup and installation.
Using Docker, you can run
hoprd on your device or a VPS.
You will interact with your node through the same Node Admin UI regardless of your installation method. All details for this can be found in the respective installation sections.
Next Steps After Completing the Onboarding Process
Ensure the following steps to start receiving rewards:
Confirm that you have configured your node with your Public IP address and port 9091, for example:
Note: If your ISP provides only a dynamic IP address, your node may not work properly and might lack peers to connect to.
Log in to your node's HOPR Admin UI and verify that Eligibility is true, and Connectivity status changes from orange to green within a 30-minute timeframe.
Once your node's connectivity status changes to green, open at least one payment channel with a random node.
To open a payment channel, go to the "PEERS" page, select a random node, and click on the "OPEN outgoing channel" icon. A popup will appear where you need to enter the amount you want to fund the outgoing channel. Currently, it is efficient to open a payment channel with at least 1 wxHOPR.
Note: The count of opened payment channels doesn't impact your rewards.
Understanding RPC importance and Setting Up Your Own Custom RPC Provider
RPC, or Remote Procedure Call, serves as a communication protocol enabling external applications like the
hoprd node to interact with the blockchain network. Ensuring the smooth operation of your node during syncing, to obtain your balances or other processes that require interaction with the blockchain is crucial. To achieve this, we strongly recommend setting up your own Gnosis Chain node.
Here are several methods for obtaining running your own node or alternatively connecting to a third party RPC provider, categorized from the most stable to less stable options:
a) Run your own Gnosis Chain node (the most secure and reliable method):
To set up a Gnosis Chain node, you will need to run the Execution Layer (EL) and Consensus Layer (CL) client. Before setting up your node, ensure that your hardware meets the necessary requirements:
Let's start with a quick overview of what needs to be done:
1. Install Sedge itself: Sedge Install Guide
2. Generate a setup for a full node (without a validator node): Generating a Full Node
After successfully setting up a full node for the Gnosis chain, please wait until it is fully synced. Afterward, you can access the RPC endpoint at http://localhost:8545. If you're using it externally, make sure to expose the port for usage.
Running a Gnosis EL+CL node will not work reliably on low spec devices such as the HORP Avado machine.
1. Visit the Stakers section: http://my.dappnode/stakers/gnosis and ensure you have selected the Gnosis chain.
2. For the Execution Layer (EL), choose Nethermind xDai. For the Consensus Layer (CL), select Lighthouse Gnosis (ensure that "Use checksync" is enabled), click Apply changes.
3. After these two packages have been installed, wait until they sync with the Gnosis network. This process may take up to several days.
4. After the EL & CL are fully synced, use your RPC endpoint URL on your HOPR node: http://nethermind-xdai.dappnode:8545.
b) Use RPC Providers from 3rd Parties (Server stability depends on company maintenance):
Several 3rd-party RPC providers are available, each with free and paid plans. We recommend trying the free plans as they are likely sufficient for running your node. Some options include:
c) Use public RPC endpoints from chainlist.org:
This method is the least reliable, as anyone can add RPC endpoints and they are heavily utilized by other users as well, making it difficult to guarantee stability and performance. Exercise caution when using endpoints from this source, they might go offline or rate limit your