Raspberry Pi
Last updated
Last updated
Turn your Raspberry Pi into a powerful contributor to the decentralized web with Webhash. This lightweight setup enables censorship-resistant website hosting — right from your desk.
Ensure you have:
Raspberry Pi 4 or 5 with at least 4GB RAM
An external SSD (recommended)
Raspberry Pi OS (64-bit recommended)
Static public IP or NAT forwarding configured
A new wallet funded with Sepolia ETH on Base
Create a new wallet using MetaMask or any EVM-compatible wallet
Export the private key (⚠️ Do NOT use your main wallet) 📺
Fund the wallet with Sepolia ETH on Base using: 👉
Use Raspberry Pi Imager to flash Raspberry Pi OS (64-bit)
Boot the Pi, open terminal, and run:
Run this command:
1️⃣ WebSocket url for Base Sepolia 2️⃣ WebSocket url 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.
After entering your Base Sepolia WebSocket URL & 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️⃣ Storage Directory Selection
You'll see this prompt:
Type y if you want to use a custome path:
Enter the mounted path, e.g., /mnt/webhash
Type n to use the default path:
/root/.webhash-node-data
📌 Ensure the SSD is mounted before choosing y
Access your router settings and do the following:
Forward TCP/UDP port 4001 to your Pi’s local IP
Assign a static IP to your Raspberry Pi in the router settings (or configure static IP on the Pi directly)
Once the setup is complete, your terminal should show:
📌 If you see “Node registered successfully,” your Raspberry Pi node is officially live and contributing to Webhash!
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!
🔗