> ## Documentation Index
> Fetch the complete documentation index at: https://node-guide.dria.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> Find answers to common questions about the Dria network

## Node Setup

> **Do I need Ollama?**
>
> **No.** The new `dria-node` binary runs models natively using llama.cpp. Ollama is no longer required. Simply run `dria-node setup` to download and configure your model.

> **What are the minimum system requirements?**
>
> * **RAM:** At least \~1 GB for the smallest model (`qwen3.5:0.8b`), up to \~27 GB for the largest (`nemotron:30b-a3b`)
> * **Disk:** 0.5 GB to 24.5 GB for model files depending on model choice
> * **Network:** Outbound UDP port 4001 (QUIC)
> * **OS:** macOS (Intel + Apple Silicon), Linux (x86\_64, arm64), Windows (x86\_64)
>
> See [Selecting Models](/selecting-models) for the full model table with RAM requirements.

> **How do I install dria-node?**
>
> The fastest way:
>
> * **macOS/Linux:** `brew install firstbatchxyz/dkn/dria-node` or `curl -fsSL https://raw.githubusercontent.com/firstbatchxyz/dkn-compute-node/master/install.sh | sh`
> * **Windows:** `irm https://raw.githubusercontent.com/firstbatchxyz/dkn-compute-node/master/install.ps1 | iex`
>
> See [Running a Node](/how-to-run) for all installation methods.

## Running a Node

> **How do I check if my node is online?**
>
> Visit the [Dria Edge AI Dashboard](https://dria.co/edge-ai) and log in with the wallet associated with your node. The dashboard shows your node's status, recent activity, and earned points.

> **Can I run multiple nodes?**
>
> Yes. You can run multiple nodes on the same machine or network, but **each node must use a unique private key (wallet)**. Using the same key for multiple nodes will cause conflicts with task assignment and rewards.

> **What ports do I need open?**
>
> Your node needs outbound access on **UDP port 4001** to connect to the Dria router via QUIC. No inbound ports need to be opened.

> **Does dria-node support GPU acceleration?**
>
> Yes. `dria-node` supports:
>
> * **Apple Metal** (macOS) — works automatically on Apple Silicon
> * **NVIDIA CUDA** — use the CUDA build
> * **AMD ROCm 6.x** — use the ROCm install script (Linux x86\_64 only)
>
> Use `--gpu-layers -1` to offload all model layers to GPU.

> **How does auto-update work?**
>
> `dria-node` checks for new versions on GitHub Releases at startup. Patch bumps (e.g. 0.7.3 → 0.7.4) show a warning. Minor or major version bumps trigger an automatic update to keep your node compatible with the network. You can skip this with `--skip-update`.

## Earning Points

> **Why am I not earning points?**
>
> Common reasons:
>
> 1. **No tasks** — There may be low demand for the model(s) you're running. Check the dashboard and consider switching to higher-demand models.
> 2. **Node offline** — Make sure `dria-node` is running and your network allows outbound UDP on port 4001.
> 3. **Low reputation** — New nodes start with a neutral reputation score. Complete tasks consistently to build it up. Failing or timing out on tasks reduces your score.
>
> Refer to the [Rewards](/rewards) page for details on the earning mechanism.

> **How often are \$DRIA Points updated?**
>
> Points on the [Dria Edge AI Dashboard](https://dria.co/edge-ai) are updated in near real-time as your node completes tasks.

## Using the Network (CLI)

> **How do I use Dria for inference?**
>
> Install the Dria CLI:
>
> ```bash theme={null}
> npm install -g @dria/cli
> dria init
> ```
>
> Then run inference:
>
> ```bash theme={null}
> dria generate -m qwen3.5:9b "explain quantum computing"
> ```
>
> See the [CLI Guide](/cli) for full documentation.

> **How does payment work for using the network?**
>
> The CLI uses USDC credits on the Base network. Top up with:
>
> ```bash theme={null}
> dria topup --amount 10
> ```
>
> This uses the x402 payment protocol with gasless EIP-712 signed transfers. See [CLI Guide](/cli) for details.

## Troubleshooting

> **My node keeps disconnecting**
>
> The node automatically reconnects with exponential backoff (1s, 2s, 4s, 8s, 16s). If it repeatedly fails:
>
> 1. Check your internet connection
> 2. Ensure outbound UDP port 4001 is not blocked by a firewall
> 3. Try setting `RUST_LOG=debug` for more detailed logs
> 4. Make sure you're running the latest version (`dria-node` auto-updates by default)

> **Model download fails**
>
> Models are downloaded from HuggingFace. If the download fails:
>
> 1. Check your internet connection
> 2. Ensure you have enough disk space in `~/.dria/models/`
> 3. Try running `dria-node setup` again — it will resume where it left off

> **Should I avoid WSL on Windows?**
>
> We recommend using native Windows (PowerShell) instead of WSL for the best experience. If you encounter issues on WSL, switch to the native Windows installation method.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.