Home PC
Last updated
Last updated
Running a Webhash Node on your home PC allows you to contribute to decentralized website hosting and earn rewards. This guide provides a step-by-step process to set up and run a node on your personal computer.
Before running the setup, ensure your system meets the following minimum requirements:
Operating System: Ubuntu, Debian, RHEL, CentOS, Fedora
Admin Access: You need root/sudo privileges
Internet Connection: Required for downloading dependencies & connecting to Webhash
Hardware Requirements:
CPU: At least 2 vCPUs
RAM: 4GB minimum
Storage: 100GB+ (SSD recommended)
Before setting up your node, you must create a new wallet and fund it with Sepolia ETH on Base for node registration.
Generate a new wallet using MetaMask or any EVM-compatible wallet.
Export the private key (⚠️ DO NOT use your primary wallet).
📺 to learn how to export your private key securely.
Fund the wallet with Sepolia ETH on Base using the official faucet: 👉
Webhash requires two WebSocket URLs: 1️⃣ One for Base Sepolia 2️⃣ One for Ethereum Mainnet
🔹 Option A: Using Alchemy (Recommended)
You only need one app to get both URLs:
Go to the Alchemy Dashboard and log in
Click "Create App"
Name: Webhash Node
Chain: Base
Network: Base Sepolia
After the app is created, click "Configure" (top right)
Under "Add Chains", enable Ethereum → Mainnet
Now go back to the app dashboard:
Click the "Network" tab
Copy the WebSocket URL for Base Sepolia
Then switch to Ethereum Mainnet and copy its WebSocket URL
✅ Examples:
Base Sepolia: wss://base-sepolia.g.alchemy.com/v2/your-api-key
Ethereum Mainnet: wss://eth-mainnet.g.alchemy.com/v2/your-api-key
📌 Ensure both URLs start with wss://
. HTTP URLs are not supported.
🔹 Option B: Using QuickNode
Create two endpoints:
One for Base Sepolia
One for Ethereum Mainnet
Go to each endpoint’s dashboard
Copy the WebSocket URL from the WebSockets tab
✅ Examples:
Base Sepolia: wss://your-node.base-sepolia.quiknode.pro/your-key/
Ethereum Mainnet: wss://your-node.ethereum.quiknode.pro/your-key/
📌 Again, make sure to copy the wss://
URLs only. HTTP endpoints won't work.
Open your terminal and run:
During the setup process, you’ll be prompted for the following:
1️⃣ Enter Base Sepolia WebSocket URL Paste the wss:// URL you obtained from Alchemy or QuickNode.
2️⃣ Enter Ethereum Mainnet WebSocket URL Paste the wss:// URL from the provider you chose.
3️⃣ Enter Your Email for Updates
After entering your Ethereum Mainnet WebSocket URL, you’ll be prompted to enter your email: Please enter your email address: This helps us send you important updates, community news, and reward announcements related to your node activity. 📌 Your email is stored securely and never shared.
4️⃣ Select Storage Directory You'll see this prompt:
Type y
to specify a custom directory (e.g., /mnt/webhash
)
Type n
to use the default path: /root/.webhash-node-data
The script will continue automatically after your input.
After setup is complete, your terminal should show output like this:
📌 If you see "Node registered successfully", your setup is complete and your node is now live and contributing to the Webhash network.
Stay connected, get support, and earn early contributor perks by being part of the Webhash community.
⚠️ Troubleshooting & Support
If you run into any issues while setting up your Webhash Node, we’re here to help!
📌 Join our Discord and create a support ticket – Our team will assist you instantly.
Go to
Once your node is successfully registered, you’ll see a message prompting you to join our official Discord and Telegram channels. 👉 Join our to claim your exclusive “🥷Node Ninja” role and connect with other node operators!
🔗