ironflow validate

Validate an ironflow.yaml configuration file without starting the server. Checks syntax, schema, environment variable references, and kind-specific rules.

ironflow validate [flags]

Flags:

Flag	Short	Type	Default	Description
--config	-f	string		Path to ironflow.yaml configuration file (required)

Output:

Validating ironflow.yaml...

  Kind:     Server
  Storage:  sqlite (.ironflow/ironflow.db)
  NATS:     embedded (memory mode)
  Auth:     DEV MODE (disabled)
  Tracing:  disabled
  Metrics:  disabled

✓ Valid. Ready to boot with: ironflow serve -f ironflow.yaml

With -f the file is the source of truth, so the environment variables the flags-only path would have read (NATS_URL, NATS_CREDS_FILE, NATS_STORE_DIR, IRONFLOW_NODE_ID, IRONFLOW_DATABASE_URL, IRONFLOW_STALE_CLAIM_THRESHOLD, and the auth secrets) are not applied. validate names each one that is set but ignored — the same list ironflow serve -f warns about:

  Ignored environment variables (with -f, the file is the source of truth):
    NATS_URL                                 → set spec.nats.url, or url: ${NATS_URL}

Examples:

ironflow validate -f ironflow.yaml
ironflow validate -f /etc/ironflow/production.yaml

---