---
title: "Environment Variables"
description: "Nexus OS reads several environment variables for configuration that shouldn't be stored in files. Variable Description Default NEXUS HOME Project directory Current directory NEXUS DB PATH Database file path data/nexus.db"
resource: https://www.aiagents.nexus/docs/manual/configuration/environment-variables
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Environment Variables

Nexus OS reads several environment variables for configuration that shouldn't be stored in files.

## Core Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `NEXUS_HOME` | Project directory | Current directory |
| `NEXUS_DB_PATH` | Database file path | `data/nexus.db` |
| `NEXUS_LOG_LEVEL` | Log verbosity | `info` |
| `NEXUS_CONFIG` | Config file path | `nexus.config.yaml` |

## Cloudflare Edge

| Variable | Description |
|----------|-------------|
| `CF_ACCOUNT_ID` | Cloudflare account ID |
| `CF_API_TOKEN` | Cloudflare API token |

## AXIS Trust

| Variable | Description |
|----------|-------------|
| `AXIS_API_KEY` | AXIS Trust API key |
| `AXIS_API_URL` | AXIS API endpoint |

## Usage

```bash
# Set for current session
export NEXUS_LOG_LEVEL=debug
export CF_API_TOKEN=your-token-here

# Or inline with command
NEXUS_LOG_LEVEL=debug naos status
```

## .env File

Nexus OS reads `.env` files in the project root:

```bash
# .env
NEXUS_LOG_LEVEL=debug
CF_ACCOUNT_ID=abc123
CF_API_TOKEN=your-token
AXIS_API_KEY=your-key
```

> **Security**: Never commit `.env` files to version control. Add `.env` to your `.gitignore`.