Home » Node-setups » Huddle01 Media Node Setup on Linux VPS
Home » Node-setups » Huddle01 Media Node Setup on Linux VPS
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.
To access your VPS, you have two options
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
There are two types of Huddle01 Media Nodes you can run:
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.