# 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](https://www.youtube.com/watch?v=ke9j2wuYhPE\&t=96s) 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](https://www.alchemy.com/faucets/base-sepolia)

***

#### 🔌 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](https://www.quicknode.com)
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:

```bash
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](https://discord.gg/zUpBGJ4uh5) **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](https://discord.gg/zUpBGJ4uh5) 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://node-setup.webhash.com/home-pc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.