Configuration

roji can be configured through a config file, environment variables, or CLI flags.

Config File#

Location: ~/.config/roji/config.yaml

network: roji                          # Docker network(s) to watch (comma-separated)
domain: dev.localhost                  # Base domain
http_port: 80                          # HTTP port (redirect to HTTPS)
https_port: 443                        # HTTPS port
certs_dir: ~/.local/share/roji/certs   # Certificate directory
data_dir: ~/.local/share/roji          # Data directory
dashboard: roji.dev.localhost          # Dashboard hostname
log_level: info                        # Log level (debug, info, warn, error)
auto_cert: true                        # Auto-generate certificates

static_sites:                          # Static file hosting (see Static Sites guide)
  - host: docs
    root: ~/projects/docs/build

Managing the Config File#

roji config show     # Display current settings
roji config path     # Show config file locations
roji config init     # Create default config file
roji config edit     # Open in $EDITOR

Environment Variables#

Settings Priority#

Settings are applied in this order (highest priority first):

1. CLI flags (--network, --domain, etc.)
2. Environment variables (ROJI_NETWORK, ROJI_DOMAIN, etc.)
3. Config file (~/.config/roji/config.yaml)
4. Defaults

Config File Validation#

roji validates the config file on startup and via roji doctor:

• Unknown keys: Detects typos in key names
• Type checking: Validates value types (string, int, bool, array, object)
• Required fields: Checks for missing required fields in static_sites

Warnings are logged during startup. Run roji doctor for a full validation report.