Skip to main content
Version: v3.0.0

Linux

info

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:

OutputUse this identifier
x86_64x86_64
aarch64aarch64
arm64aarch64

Install HOPRd node

Before proceeding, select Linux distribution:

  1. Download .deb package

    1. Go to the Releases page and expand the Assets section to view all files.

    2. Use the machine identifier from a previous step and locate the appropriate Debian/Ubuntu package (.deb format).

    3. 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.

  2. 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:

    VariableDescription
    <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.

  3. Install and launch HOPRd package

    Install HOPRd package using commands below:

    sudo apt-get update
    sudo -E apt -y install ./hoprd.deb

Configure hoprd node

  1. Adjust environment variables

    Below is a quick reference of all the necessary environment variables you may need to configure:

    FlagDescription
    HOPRD_HOSTYour public libp2p endpoint <YOUR_PUBLIC_IP>:<LIBP2P_PORT> (Default libp2p port is 9091)
    HOPRD_PASSWORDPassphrase 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_TOKENYour Admin UI API token
    HOPRD_SAFE_ADDRESSYour staking Safe wallet address
    HOPRD_MODULE_ADDRESSYour staking Module contract address
    HOPRD_PROVIDERGnosis Chain RPC URL (see Custom RPC provider guide).
    HOPRD_API_PORTREST 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.

  2. 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


  1. Retrieve HOPRd node address

    1. Once you've completed the HOPRd installation, the terminal will output the HOPRd configuration.
    2. In the configuration output, locate the Node Address.
  2. 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.

    info

    There'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:

  1. Install the HOPR Admin UI

    Install HOPR Admin UI and connect to your node via the HOPR Admin UI.

  2. Check if the node is 100% synced

    On the INFO page, under the Network section, confirm that the Sync Process is at 100%.
    If it’s not fully synced yet, you’ll need to wait until the process is complete.

  3. Open outgoing channel and verify

    1. Once synced, go to the PEERS page and select a random peer with a connection quality above 90%.
      Click the OPEN Outgoing Channel icon, enter 1 as the amount (or another value), and click Open Channel.
      You’ll receive a notification once the channel has been opened.

    2. 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.