---
title: "Environment Variables"
description: "All environment variables recognized by Nexus OS. Variable Default Description NEXUS HOME . Project root directory NEXUS DB PATH data/nexus.db Database file location NEXUS CONFIG nexus.config.yaml Config file path NEXUS "
resource: https://www.aiagents.nexus/docs/manual/appendix/environment-variables
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Environment Variables

All environment variables recognized by Nexus OS.

## Core Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `NEXUS_HOME` | `.` | Project root directory |
| `NEXUS_DB_PATH` | `data/nexus.db` | Database file location |
| `NEXUS_CONFIG` | `nexus.config.yaml` | Config file path |
| `NEXUS_LOG_LEVEL` | `info` | Log verbosity (trace/debug/info/warn/error) |
| `NEXUS_LOG_FORMAT` | `text` | Log format (text/json) |

## Cloudflare Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `CF_ACCOUNT_ID` | none | Cloudflare account ID |
| `CF_API_TOKEN` | none | Cloudflare API token |
| `CF_WORKER_PREFIX` | `nexus-` | Worker name prefix |

## Dashboard Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `NEXUS_DASH_PORT` | `4200` | Dashboard port |
| `NEXUS_DASH_HOST` | `127.0.0.1` | Dashboard bind address |
| `NEXUS_DASH_TOKEN` | none | Dashboard auth token |

## AXIS Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `AXIS_REGISTRY_URL` | default | AXIS registry endpoint |
| `AXIS_CACHE_TTL` | `3600` | Cache TTL in seconds |
| `AXIS_TIMEOUT` | `10` | Request timeout in seconds |

## Precedence

Configuration is resolved in this order (highest priority first):

1. CLI flags (`--port 4201`)
2. Environment variables (`NEXUS_DASH_PORT=4201`)
3. Config file (`nexus.config.yaml`)
4. Built-in defaults