Huddle01 Media Node Setup on Linux VPS

Minimum requirements

4 CPU Cores, 4 GB RAM, 32 GB Disk Space, 250 Mbps Internet Speed

Difficulty grade:
Beginner 33%

Huddle01 Media Node Setup on Linux VPS

Minimum requirements

4 CPU Cores, 4 GB RAM, 32 GB Disk Space, 250 Mbps Internet Speed

Difficulty grade:
Beginner 33%

Video tutorial

Need help setting up your node?

Step-by-Step GUIDE

Disclaimer

The information provided in this guide is for general informational purposes only. By accessing or using this guide, you acknowledge and agree that the author and this website shall not be held responsible or liable for any errors, omissions, or outcomes resulting from the use of this material. This includes, without limitation, any direct, indirect, incidental, or consequential damages to hardware, software, data, or any other property. While reasonable efforts have been made to ensure the accuracy and reliability of the content, no warranties or guarantees are provided, either express or implied. Users assume full responsibility for the implementation of any instructions contained herein and are strongly advised to perform appropriate backups and due diligence before proceeding. For official support or the most up-to-date information, please consult the relevant project’s official documentation or support channels.

Section 1: Connecting to the VPS

To access your VPS, you have two options

  • Built-in Console: Most providers (e.g., DigitalOcean) offer a web-based console in their dashboard — no setup required.
  • SSH Method: Use PowerShell or PuTTY on Windows, or Terminal on macOS/Linux — most VPS use root as the default username.

Run this command:

ssh username@your_server_ip

Replace username and your_server_ip with your actual VPS login credentials. You’ll be prompted to enter the password to complete the login.
Example: ssh root@192.0.2.123

Section 2: Installing and Running the Node

There are two types of Huddle01 Media Nodes you can run:

  • Basic Media Node – Handles up to 10 delegators (uses minimum hardware)
  • High-Performance Node – Supports up to 40 delegators (uses recommended hardware)

When others delegate their nodes to yours, you earn a commission — and you set the rate.

 

Hardware Requirements
 

Minimum (for up to 10 delegators):
4 CPU Cores, 4 GB RAM, 32 GB Disk Space, 250 Mbps Internet Speed

 

Recommended (for up to 40 delegators):
≥ 8 CPU Cores, ≥ 8 GB RAM, 32 GB Disk Space, ≥ 1 Gbps Internet Speed

 

1. Update Your Ubuntu VPS

This command updates your package list and upgrades any outdated software packages to their latest version:

sudo apt update && sudo apt upgrade -y

 

2. Install Required Tools

Huddle01 requires curl to download and run the installation script. This command installs it:

sudo apt install curl -y

 

3. Install ffmpeg

ffmpeg is used to process video and audio streams. It’s required for your media node to work properly:

sudo apt install ffmpeg -y

After installation, check that it installed correctly by checking the version:

ffmpeg -version

If you’re not using Ubuntu, follow this guide: ffmpeg installation instructions

 

4. Install the Huddle01 Media Node

This command downloads and runs the official Huddle01 installation script:

curl -fsSL https://huddle01.network/api/install.sh | bash

The installer adds the Huddle01 binary to a hidden folder called .hudl in your home directory and updates your shell configuration to recognize it. However, you may need to manually reload the configuration to make it available in your current terminal session.

Run the following command to apply the change immediately:

source ~/.bashrc

Now check that the installation succeeded:

hudl --version

If you still get a “command not found” error, you can run it manually using the full path:

/root/.hudl/hudl --version

 

5. Configure a Burner Wallet

This wallet will be linked to your node to receive rewards. It’s called a “burner” wallet because it’s temporary and used only for this node:

hudl wallet configure

Follow the on-screen prompts to complete setup.

 

6. Start the Media Node

This command starts your media node in the background so it continues to run even if you close the terminal:

hudl node start -d

 

7. Create a Media Node Pool

Your node won’t earn rewards until it’s linked to a “Media Node Pool”. You’ll be guided to create one after the node starts, or you can find the option in your Huddle01 dashboard.

 

8. Update the Node (When Needed)

If Huddle01 releases a new version, follow these steps to update:

Stop your node before updating:

hudl node stop

Download and install the latest version:

hudl node update

Start your node again:

hudl node start

Verify that you’re running the latest version:

hudl --version

 

🔐 Bonus: How to Export Your Private Key

If you ever need to back up or migrate your burner wallet, you can view its private key using this command:

hudl wallet details

When prompted:

Private Key [Enter Y/n to Show]:

→ Type Y and press Enter. Your private key will then be displayed in the terminal. Copy it and store it somewhere secure (preferably offline).

 

🎉 Congratulations — Your Huddle01 Node Is Live!

You’re now helping decentralize video and voice infrastructure — and earning crypto rewards in return. Keep your node online and up to date to maximize your commissions and impact.

STAY IN THE LOOP

Get exclusive project updates, tutorials & community perks—right in your inbox.

STAY IN THE LOOP

Get exclusive project updates, tutorials & community perks—right in your inbox.