Configuration Directives

Configuration directives index — every section of the ColdBox class at a glance.

All application configuration lives in the ColdBox class (config/ColdBox.bx, or config/ColdBox.cfc for CFML apps) inside its configure() method. Each top-level struct is a directive:

Directive	Purpose	Page
coldbox	Core framework behavior — app name, event name, handlers, caching, error handling	ColdBox Directives
conventions	Override default folder/file conventions	ColdBox Directives
environments	Per-environment config overrides	ColdBox Directives
flash	Flash scope storage	ColdBox Directives
interceptors / interceptorSettings	Registered interceptors and their config	ColdBox Directives
layouts / layoutSettings	Layout registrations and behavior	ColdBox Directives
settings	Custom application settings	ColdBox Directives
executors	Named async executor pools for your app	ColdBox Directives
sse	Server-Sent Events behavior (BoxLang only)	ColdBox Directives
modules	Module loading and behavior	Modules & Module Settings
moduleSettings	Per-module settings	Modules & Module Settings
cachebox	Caching — see the CacheBox book for the full DSL	CacheBox Directive
logbox	Logging — see the LogBox book for the full DSL	LogBox Directive
wirebox	Dependency injection — see the WireBox book for the full DSL	WireBox Directive

Environment Variables & Java Properties

Any directive can be overridden externally without touching code: System Settings.

A Note on the Companion Frameworks

CacheBox, LogBox, and WireBox are standalone frameworks with their own books. ColdBox docs cover how the ColdBox class wires them in; their internal DSLs (cache providers, appenders, binder mappings) are documented in their own books — see Companion Frameworks.