macOS
Please note that you must start the onboarding process before setting up your node. To start, visit the Overview page.
This guide explains how to install and run the HOPRd node natively on macOS using Homebrew, the macOS package manager. Installing HOPRd as a native package means it integrates with your system in a standard, macOS-friendly way—no containers or virtualization needed.
Install HOPRd node
-
Install Homebrew
- Open the Terminal application on your macOS.
- Install Homebrew follow this guide: https://brew.sh.
-
Install HOPRd using homebrew
Install the HOPRd package on your macOS using Homebrew:
brew tap hoprnet/hoprd
brew install [email protected]
Configure HOPRd node
-
Edit environment variables
-
Open the Terminal application and edit the
hoprd.env
file by running command:sudo vim $(brew --prefix)/etc/hoprd/hoprd.env
-
Below is a quick reference for all the variables you’ll need to adjust:
Variable Description HOPRD_PROVIDER
Gnosis Chain RPC URL (see Custom RPC provider guide). HOPRD_SAFE_ADDRESS
Your staking Safe wallet address HOPRD_MODULE_ADDRESS
Your staking Module contract address Once you finished, save file.
-
-
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
)Edit the environment variables file by running this command:
sudo vim $(brew --prefix)/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.
Edit the configuration file by running this command:
sudo vim $(brew --prefix)/etc/hoprd/hoprd.cfg.yaml
-
Link your node to your HOPR Safe wallet
-
Retrieve HOPRd node address
- Once you completed HOPRd installation it outputs HOPRd configuration.
- In the HOPRd configuration locate 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:
-
Start the HOPRd node
After completing the onboarding process, start your node by running the command:
brew services start hoprd
-
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.