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

# 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:

# .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.