Configuration

Configure CodexDNS using JSON files, environment variables, and the web UI. Includes a full parameter reference and environment variable guide.

CodexDNS uses a hybrid configuration system: a JSON file (config.json) provides bootstrap settings at startup, while the Web UI and database allow runtime changes without restarts.

This section covers:

Runtime Configuration — changing settings live via the Web UI or API
Export & Import — backing up and restoring configuration
Configuration Parameters Reference — every JSON config key with its type, default value, environment variable equivalent, and description
Environment Variables — naming convention, precedence rules, sensitive secrets, and running without a config file

Runtime Configuration

Change settings at runtime without restarting the server.

Export & Import Config

Backup, export, and restore configuration files.

Configuration Parameters Reference

Complete reference for all CodexDNS configuration file parameters, organized by group.

Environment Variables

Configure CodexDNS using environment variables, including special secrets and bootstrap-only variables.