Configuration

Ironclad configuration comes from:

  1. CLI flags
  2. environment variables prefixed with IC_
  3. a config file

CLI flags

Global flags:

  • -v, -vv, -vvv increase log verbosity
  • --config-file PATH use a specific config file
  • --catalog-dir PATH point at the exact catalog directory

Config file

By default Ironclad looks for:

~/.config/ironclad/config.toml

Environment variables

Environment variables are read with the IC_ prefix.

Examples:

  • IC_CATALOG_DIR
  • IC_VERBOSE

Practical use

Use CLI flags when you need an explicit override.

The simplest rule is:

  • use --catalog-dir when you want one command to target a specific catalog directory
  • use environment variables or a config file for longer-lived defaults