2️⃣Home PC

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.

✅ Step 1: System Requirements

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)

🔐 Step 2: Create a New Wallet & Fund It

Before setting up your node, you must create a new wallet and fund it with Sepolia ETH on Base for node registration.

  1. Generate a new wallet using MetaMask or any EVM-compatible wallet.

  2. Export the private key (⚠️ DO NOT use your primary wallet).

    📺 Watch this video to learn how to export your private key securely.

  3. Fund the wallet with Sepolia ETH on Base using the official faucet: 👉 Base Sepolia Faucet – Alchemy

🔌 Step 3: Get Your WebSocket URLs (Base Sepolia + Ethereum Mainnet)

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:

  1. Go to the Alchemy Dashboard and log in

  2. Click "Create App"

    • Name: Webhash Node

    • Chain: Base

    • Network: Base Sepolia

  3. After the app is created, click "Configure" (top right)

  4. Under "Add Chains", enable Ethereum → Mainnet

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

  1. Go to QuickNode

  2. Create two endpoints:

    • One for Base Sepolia

    • One for Ethereum Mainnet

  3. Go to each endpoint’s dashboard

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

⚙️ Step 4: Run the Setup Script

Open your terminal and run:

curl -fsSL https://raw.githubusercontent.com/WebHash-eth/hash-node-setup/refs/heads/main/scripts/setup.sh > setup.sh && chmod +x setup.sh && ./setup.sh

🛠️ Setup Prompts

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:

Do you want to use a separate disk for storage? (y/n)

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

✅ Step 5: Confirm Node Registration

After setup is complete, your terminal should show output like this:

✔ Container node       Healthy
✔ Container pinner     Started
Waiting for node container to be ready...
Configuring node...
Node started with peer ID: 12D3KooW...
Registering node with peer ID: 12D3KooW...
Node registered successfully with peer ID: 12D3KooW...

📌 If you see "Node registered successfully", your setup is complete and your node is now live and contributing to the Webhash network.

📢 Final Step – Join the Webhash Community

Once your node is successfully registered, you’ll see a message prompting you to join our official Discord and Telegram channels. 👉 Join our Discord to claim your exclusive “🥷Node Ninja” role and connect with other node operators!

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.

🔗 Join Webhash Discord

PreviousRaspberry PiNextAWS - Amazon Cloud Service

Last updated