Node update for existing node operators - April 2025

If you've already set up a Webhash node, please rerun the updated setup script to apply three important changes:

1. Provide your own Base Sepolia WebSocket URL.

2. Provide your own Ethereum Mainnet WebSocket URL.

3. Choose a custom storage directory.

---

🛠 Step-by-Step for Existing Users

1️⃣ Rerun 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

---

2️⃣ Enter Base Sepolia WebSocket URL & Ethereum Mainet WebSocket URL

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

---

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

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

✅ Example Output:

✓ Using default path: /root/.webhash-node-data
Moving IPFS data to /root/.webhash-node-data/ipfs
Existing IPFS dir: /var/lib/docker/volumes/webhash-node_node_data/_data
Moving export data to /root/.webhash-node-data/export
Existing export dir: /var/lib/docker/volumes/webhash-node_node_export/_data
Starting node with public IP: xxx.xxx.xxx.xxx...

---

6️⃣ Confirm Node Is Running

After setup completes, your terminal will show:

✔ 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 node is running perfectly!

---

🧹 Optional: Clean Up Old Docker Volumes

Free up space by removing legacy volumes after confirming your new setup is working:

sudo docker volume rm webhash-node_node_data
sudo docker volume rm webhash-node_node_export

⚠️ Only perform this cleanup after verifying your node is healthy and registered.

---

📢 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 doing this, we’re here to help!

📌 Create a support ticket on discord – Our team will assist you instantly.

🔗 Join Webhash Discord