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
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
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
3. Verify registration
Heartbeat
Confirm heartbeats are visible in registry logs.
Health endpoint
Check GET /health returns ok from your node.
First job
Send a test prompt from the SDK and verify the node is selected.
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
Do not expose admin ports publicly. Restrict management endpoints with network policies.
