Environment Variables

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

Core Variables

VariableDescriptionDefault
NEXUS_HOMEProject directoryCurrent directory
NEXUS_DB_PATHDatabase file pathdata/nexus.db
NEXUS_LOG_LEVELLog verbosityinfo
NEXUS_CONFIGConfig file pathnexus.config.yaml

Cloudflare Edge

VariableDescription
CF_ACCOUNT_IDCloudflare account ID
CF_API_TOKENCloudflare API token

AXIS Trust

VariableDescription
AXIS_API_KEYAXIS Trust API key
AXIS_API_URLAXIS 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.