coldbox-configuration

Configure ColdBox application settings and environment-specific overrides in ColdBox.cfc.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ColdBox/skills --skill coldbox-configuration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coldbox-configuration
Source: https://github.com/ColdBox/skills/tree/main/coldbox/configuration
Command: npx skills add https://github.com/ColdBox/skills --skill coldbox-configuration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and simplifies application configuration for ColdBox projects by providing a clear, production-ready template and best practices for ColdBox.cfc settings, environment overrides, module configuration, logging, caching, and dependency wiring.

Core Features & Use Cases

  • Environment Management: Define development, staging, and production overrides and hostname-based environment detection patterns.
  • Module & Service Configuration: Provide structured moduleSettings for third-party modules and custom modules, including security and ORM options.
  • Logging, Caching, and DI: Configure LogBox appenders and categories, reference CacheBox configuration, and wire dependencies with WireBox binder settings.
  • Use Case: Prepare a new ColdBox application with secure secret handling, separate dev/prod logging behavior, and modular overrides for CBORM and CBAuth.

Quick Start

Open your ColdBox.cfc, add coldbox, environments, moduleSettings, logbox, cachebox, and wirebox sections, and use getSystemSetting for all secrets and environment-specific values.

Frequently Asked Questions about coldbox-configuration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure environment-specific settings in ColdBox.cfc for staging and production?

Configure environment-specific settings in ColdBox.cfc by defining environment overrides using hostname detection patterns. You can structure separate development, staging, and production behaviors to apply per-environment logging policies and deployment configurations automatically.

What is the best way to manage secrets and environment variables in a ColdBox application?

Manage secrets in a ColdBox application by using the getSystemSetting function within your ColdBox.cfc configuration. This approach securely retrieves environment variables for sensitive data instead of hardcoding values directly into your application configuration files.

How do I set up LogBox appenders and CacheBox caches in ColdBox?

Set up LogBox appenders and CacheBox caches by adding the logbox and cachebox configuration sections inside ColdBox.cfc. This allows you to define specific appenders, logging categories, and cache behaviors for your application's dependency injection and caching needs.

Can I use ColdBox configuration settings with both BoxLang and CFML syntax?

Yes, ColdBox configuration settings support both BoxLang and CFML syntax compatibility. You can define your ColdBox.cfc settings, WireBox binders, and moduleSettings structures ensuring your application configuration runs correctly across both platforms.

How do I configure custom modules and CBORM settings in ColdBox?

Configure custom modules and CBORM settings in ColdBox by using the structured moduleSettings block within ColdBox.cfc. This provides a centralized location to define security options, ORM configurations, and third-party module overrides for your application.