Linux
Please note that you must start the onboarding process before setting up your node. To start, visit the Overview page.
When installing HOPRd via native packages on Linux (e.g., .deb
or .rpm
), the node integrates directly into the Linux file system using standard conventions.
Determine machine architecture
In your terminal window, run the following command to determine your machine’s architecture:
uname -m
Based on the output, use the corresponding identifier in the next step to download the appropriate HOPRd package for your operating system:
Output | Use this identifier |
---|---|
x86_64 | x86_64 |
aarch64 | aarch64 |
arm64 | aarch64 |
Install HOPRd node
Before proceeding, select Linux distribution:
- Debian / Ubuntu
- RHEL / Fedora / CentOS
- Arch Linux
-
Download
.deb
package-
Go to the Releases page and expand the Assets section to view all files.
-
Use the machine identifier from a previous step and locate the appropriate Debian/Ubuntu package (.deb format).
-
Download the HOPRd package using:
curl -o hoprd.deb -L <HOPRd_package_link>
Replace
<HOPRd_package_link>
with the actual URL from the Releases page. Example:https://github.com/hoprnet/hoprnet/releases/download/v3.0.0/hoprd_3.0.0_aarch64.deb
. It will download the contents of the HOPRd package and write them into the file:hoprd.deb
.
-
-
Export variables
Export the necessary variables before proceeding to install the HOPRd package:
export HOPRD_SAFE_ADDRESS=<SAFE_WALLET_ADDRESS>
export HOPRD_MODULE_ADDRESS=<MODULE_ADDRESS>
export HOPRD_PROVIDER=<CUSTOM_RPC_PROVIDER>Below is a quick reference for all the variables you’ll need to adjust:
Variable Description <SAFE_WALLET_ADDRESS>
Your staking Safe wallet address <MODULE_ADDRESS>
Your staking Module contract address <CUSTOM_RPC_PROVIDER>
Gnosis Chain RPC URL (see Custom RPC provider guide). Once you have adjusted the values, execute the command to export variables.
-
Install and launch HOPRd package
Install HOPRd package using commands below:
sudo apt-get update
sudo -E apt -y install ./hoprd.deb
-
Download
.rpm
package-
Go to the Releases page and expand the Assets section to view all files.
-
Use the machine identifier from a previous step and locate the appropriate Debian/Ubuntu package (.rpm format).
-
Download the HOPRd package using:
curl -o hoprd.rpm -L <HOPRd_package_link>
Replace
<HOPRd_package_link>
with the actual URL from the Releases page. Example:https://github.com/hoprnet/hoprnet/releases/download/v3.0.0/hoprd_3.0.0_aarch64.rpm
. It will download the contents of the HOPRd package and write them into the file:hoprd.rpm
.
-
-
Export variables
Export the necessary variables before proceeding to install the HOPRd package:
export HOPRD_SAFE_ADDRESS=<SAFE_WALLET_ADDRESS>
export HOPRD_MODULE_ADDRESS=<MODULE_ADDRESS>
export HOPRD_PROVIDER=<CUSTOM_RPC_PROVIDER>Below is a quick reference for all the variables you’ll need to adjust:
Variable Description <SAFE_WALLET_ADDRESS>
Your staking Safe wallet address <MODULE_ADDRESS>
Your staking Module contract address <CUSTOM_RPC_PROVIDER>
Gnosis Chain RPC URL (see Custom RPC provider guide). Once you have adjusted the values, execute the command to export variables.
-
Install and launch HOPRd package
Install HOPRd package using commands below:
sudo dnf update -y
sudo -E dnf install -y ./hoprd.rpm
-
Download
.pkg.tar.zst
package-
Go to the Releases page and expand the Assets section to view all files.
-
Use the machine identifier from a previous step and locate the appropriate Debian/Ubuntu package (.pkg.tar.zst format).
-
Download the HOPRd package using:
curl -o hoprd.pkg.tar.zst -L <HOPRd_package_link>
Replace
<HOPRd_package_link>
with the actual URL from the Releases page. Example:https://github.com/hoprnet/hoprnet/releases/download/v3.0.0/hoprd_3.0.0_aarch64.pkg.tar.zst
. It will download the contents of the HOPRd package and write them into the file:hoprd.pkg.tar.zst
.
-
-
Export variables
Export the necessary variables before proceeding to install the HOPRd package:
export HOPRD_SAFE_ADDRESS=<SAFE_WALLET_ADDRESS>
export HOPRD_MODULE_ADDRESS=<MODULE_ADDRESS>
export HOPRD_PROVIDER=<CUSTOM_RPC_PROVIDER>Below is a quick reference for all the variables you’ll need to adjust:
Variable Description <SAFE_WALLET_ADDRESS>
Your staking Safe wallet address <MODULE_ADDRESS>
Your staking Module contract address <CUSTOM_RPC_PROVIDER>
Gnosis Chain RPC URL (see Custom RPC provider guide). Once you have adjusted the values, execute the command to export variables.
-
Install and launch HOPRd package
Install HOPRd package using commands below:
sudo pacman -Syu
sudo -E pacman --noconfirm -U ./hoprd.pkg.tar.zst
Configure hoprd node
-
Adjust environment variables
Below is a quick reference of all the necessary environment variables you may need to configure:
Flag Description HOPRD_HOST
Your public libp2p endpoint <YOUR_PUBLIC_IP>:<LIBP2P_PORT>
(Default libp2p port is9091
)HOPRD_PASSWORD
Passphrase used to encrypt your identity file. Make sure to write it down, as you'll need it to restore your node in the future. If the HOPRD_PASSWORD
environment variable is not set during installation, a new password will be generated automatically.HOPRD_API_TOKEN
Your Admin UI API token HOPRD_SAFE_ADDRESS
Your staking Safe wallet address HOPRD_MODULE_ADDRESS
Your staking Module contract address HOPRD_PROVIDER
Gnosis Chain RPC URL (see Custom RPC provider guide). HOPRD_API_PORT
REST API port to access via Admin UI (Default port is 3001
)These environment variables are stored in:
/etc/hoprd/hoprd.env
You can find a full list of supported environment variables in the HOPRNET github repository.
-
Adjust node configuration properties (optional)
By default, the configuration file is pre-configured and works well as is. However, if you have a clear understanding of the settings and their implications, you can customize them to better align with your specific needs. For detailed instructions, please refer to the section: Understanding Node Strategies.
The configuration file is located at:
/etc/hoprd/hoprd.cfg.yaml
Link your node to your HOPR Safe wallet
-
Retrieve HOPRd node address
- Once you've completed the HOPRd installation, the terminal will output the HOPRd configuration.
- In the configuration output, locate the Node Address.
-
Register node address on the HOPR Staking Hub
Go to HOPR Staking Hub and register for the waitlist, or complete onboarding if you’ve been approved.
infoThere's no need to manually fund your node with xDai tokens. Funding will happen during onboarding via the HOPR Staking Hub.
What's next?
Once you've completed the onboarding process, ensure your node is fully synced (100%
) and that you've opened at least one outgoing payment channel with a random peer.
To start earning rewards through Cover Traffic, follow these steps to meet the necessary requirements:
-
Install the HOPR Admin UI
Install HOPR Admin UI and connect to your node via the HOPR Admin UI.
-
Check if the node is 100% synced
On the
INFO
page, under theNetwork
section, confirm that theSync Process
is at100%
.
If it’s not fully synced yet, you’ll need to wait until the process is complete. -
Open outgoing channel and verify
-
Once synced, go to the
PEERS
page and select a random peer with a connection quality above90%
.
Click theOPEN Outgoing Channel
icon, enter1
as the amount (or another value), and click Open Channel.
You’ll receive a notification once the channel has been opened. -
Navigate to the
CHANNELS: OUT
page to verify that the outgoing payment channel has been successfully opened.
-
Congratulations! Your node should now be fully operational and earning rewards. Be sure to periodically check that your node is performing properly.