# Grid Node Delegate Guide

**How to Run a Circuit Node**

Grid lets you contribute compute to the network by running a Circuit Node and delegating your Node License to it via a job execution wallet. Follow the steps below to get started.

***

**Prerequisites**

Before starting, ensure you have:

* Docker installed (on Linux, Mac, or Windows)
* A wallet address that owns node licenses (used in the `OWNERS_ALLOWLIST`)
* A separate burner wallet address (automatically generated by the node client and delegated to the Circuit Node)
* Testnet ETH on Arbitrum Sepolia (for gas on the burner wallet during testnet)

***

**Hardware Requirements**

**Minimum:**

* CPU with 1+ cores
* 2GB RAM
* 5GB Disk Space
* 4Mbps Internet Connection

**Recommended:**

* Fast CPU with 2+ cores
* 4GB+ RAM
* 10GB+ Disk Space
* 8+ Mbps Internet Connection

> **Note:** The Circuit Node does **not** need a static IP address or open ports.

***

**Step 1: Run the Circuit Node**

**Linux & Mac**

Open your terminal and run:

```bash
mkdir -p ~/flohive && docker run --pull always -v ~/flohive:/app/cache \
-e OWNERS_ALLOWLIST=0xLicenseOwnerAddress gr1dnetwork/circuit-node
```

**Windows**

Open Command Prompt and run:

```cmd
mkdir %USERPROFILE%\flohive 2>nul & docker run --pull always -v %USERPROFILE%\flohive:/app/cache ^
-e OWNERS_ALLOWLIST=0xLicenseOwnerAddress gr1dnetwork/circuit-node
```

> **Important:**\
> The `OWNERS_ALLOWLIST` environment variable **must** be set to the wallet address that owns your Grid node licenses.\
> This allows the node to validate ownership before participating in job execution.

***

**Step 2: Delegate a Burner Wallet**

After the node is up and running:

1. Visit [https://run.gr1d.network⁠](https://run.gr1d.network/)
2. Connect your wallet that holds the node license(s)
3. Click the **“Delegate”** button
4. Enter your **burner wallet address**
5. Click **“Delegate”** to finalize

This links the execution wallet to your node license.

***

**Step 3: Fund the Burner Wallet**

Your burner wallet needs gas to execute jobs.

To get your node burner address, check the logs for the following output:

```bash
[INFO] Using burner wallet {"address":"burner_address"}
```

* During testnet, send **testnet ETH on Arbitrum Sepolia** to your burner address.
* You can get testnet ETH from Sepolia faucets, e.g.:\
  [https://hackquest.io/faucets/421614⁠](https://hackquest.io/faucets/421614)

***

**Done!**

You’re now ready to run a Circuit Node and contribute to the Grid network.\
Jobs will be executed on-chain via your delegated burner wallet.
