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


---

# 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://docs.gr1d.network/circuit-nodes-101/grid-node-delegate-guide.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.
