> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bidsmith.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Run node

> Provision, register, and operate an ARIS worker node in production.

## Prerequisites

* Linux host with Docker 24+
* Stable outbound connectivity to the registry
* GPU driver/runtime configured (if running GPU workloads)
* Node keypair and operator wallet

## 1. Create node configuration

```yaml theme={null}
node_id: node-us-east-01
registry_url: https://aris-api-production.up.railway.app/
listen_addr: 0.0.0.0:9006
max_concurrency: 8
models:
  - tinyllama
  - mistral-7b
wallet:
  address: 0x1234...abcd
```

## 2. Start the worker

<CodeGroup>
  ```bash Docker theme={null}
  docker run --rm -it \
    -p 9006:9006 \
    -v $(pwd)/node-config.yaml:/app/node-config.yaml \
    aris/node:latest \
    aris-node start --config /app/node-config.yaml
  ```

  ```bash Native theme={null}
  aris-node start --config ./node-config.yaml
  ```
</CodeGroup>

## 3. Verify registration

<Steps>
  <Step title="Heartbeat">
    Confirm heartbeats are visible in registry logs.
  </Step>

  <Step title="Health endpoint">
    Check `GET /health` returns `ok` from your node.
  </Step>

  <Step title="First job">
    Send a test prompt from the SDK and verify the node is selected.
  </Step>
</Steps>

## Operational checklist

* Keep clock drift under 1 second (NTP enabled)
* Rotate node credentials on schedule
* Pin model versions per environment
* Set memory and concurrency limits

<Warning>
  Do not expose admin ports publicly. Restrict management endpoints with network policies.
</Warning>