boxlang-configuration

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides developers to configure BoxLang runtime settings through boxlang.json, while showing how to override values with environment variables or JVM properties, and how to configure datasources, caches, executors, modules, logging, security, and schedulers. It also clarifies how Application-level settings relate to global runtime configuration.

Core Features & Use Cases

  • Centralized guidance for configuring runtime behavior across the platform, including boxlang.json structure, environment substitution, and per-app overrides.
  • Practical use cases for development, testing, and production deployments, such as per-app datasources, cache mappings, and module tuning.
  • Best practices for safe configuration, validation, and maintainability.

Quick Start

Edit boxlang.json and run your BoxLang project to apply the runtime configuration immediately.

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 using boxlang.json?

Configure BoxLang runtime settings by editing boxlang.json to define datasources, caches, executors, modules, logging, and schedulers. Running your BoxLang project immediately applies the runtime configuration globally or per-application.

Can I override BoxLang configuration values with environment variables?

Yes, you can override BoxLang configuration values defined in boxlang.json by using environment variable substitution and JVM properties. This supports safe, scalable runtime behavior across local development, cloud deployments, and production servers.

What is the best way to manage per-application overrides in BoxLang?

The best way to manage per-application overrides in BoxLang is through Application.bx integration. This allows individual applications to specify custom datasources, cache mappings, and module tuning while inheriting global runtime defaults.

Does BoxLang support environment variable substitution for production deployments?

Yes, BoxLang supports environment variable substitution for production deployments. This allows you to safely override JSON configuration values and manage runtime settings across varied environments without modifying the core boxlang.json file.

What runtime components can I configure in boxlang.json?

In boxlang.json, you can configure core runtime components including datasources, caches, executors, modules, logging, security settings, and schedulers. This centralized configuration guides safe runtime behavior across the platform.

Why are my per-application BoxLang settings not overriding global defaults?

Per-application BoxLang settings may fail to override global defaults if Application.bx integration is improperly wired or environment variable substitution conflicts with boxlang.json values. Validate your JSON overrides and module loading configurations to ensure correct hierarchy resolution.