boxlang-configuration

Configure BoxLang runtime settings via boxlang.json and environment variables.

16|78|Updated Nov 28, 2014
One-click install
npx skills add https://github.com/ortus-docs/coldbox-docs --skill boxlang-configuration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: boxlang-configuration
Source: https://github.com/ortus-docs/coldbox-docs/tree/main/.agents/skills/boxlang-configuration
Command: npx skills add https://github.com/ortus-docs/coldbox-docs --skill boxlang-configuration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the challenge of configuring BoxLang runtime behavior consistently across environments by centralizing settings in boxlang.json and environment variables.

Core Features & Use Cases

  • Documentation of boxlang.json structure and directives for datasources, caches, executors, modules, logging, security, and schedulers.
  • Guidance on environment variable overrides and per-application settings via Application.bx.
  • Use cases include setting up a new BoxLang deployment, overriding configuration for different environments (dev/stage/prod), and debugging runtime behavior.

Quick Start

Edit your boxlang.json to set a sample datasource and logging level, then restart BoxLang to apply changes.

Frequently Asked Questions about boxlang-configuration

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

FAQPage Schema
How do I configure BoxLang runtime settings for different environments?

You can configure BoxLang runtime settings by centralizing them in a boxlang.json file and using environment variables to override values for dev, stage, or prod environments.

What is the structure of boxlang.json for setting up datasources and logging?

The boxlang.json structure uses core directives to define datasources, caches, executors, modules, logging, security, and schedulers to consistently control runtime behavior.

Can I override BoxLang runtime configuration per application?

Yes, you can apply per-application configuration overrides by defining specific settings within the Application.bx file to customize the BoxLang runtime behavior.

How do I use environment variables to override BoxLang configuration values?

Environment variables substitute or override configuration values defined in boxlang.json, allowing you to manage runtime settings like datasources and logging without modifying files.

What's the best way to wire caches and schedulers in a BoxLang deployment?

The best way to wire caches and schedulers is by defining them in your boxlang.json using the dedicated core directives, then restarting BoxLang to apply the changes.