Blog

12 Days of BoxLang - Day 2: CommandBox

Maria Jose Herrera December 11, 2025

Spread the word

Maria Jose Herrera

December 11, 2025

Spread the word


Share your thoughts

12 Days of BoxLang – Day 2 🎄

BoxLang + CommandBox: The Enterprise Engine Behind Your Deployments

For Day 2 of our 12 Days of Christmas series, we’re diving into one of the most powerful parts of the BoxLang ecosystem: CommandBox the defacto enterprise servlet deployment platform for BoxLang.

If BoxLang is the language powering your applications, CommandBox is the engine room behind it all. ⚙️


🚀 CommandBox + BoxLang: The Ultimate Deployment Stack

CommandBox is a standalone, native CLI and embedded server for Windows, macOS, and Linux. It brings developer productivity, package management, application scaffolding, and a robust JEE server-all in one simple tool.

BoxLang runs beautifully on multiple runtimes (JVM, web, desktop), but when it comes to enterprise servlet deployment, CommandBox leads the way.

It provides a specialized servlet runtime built specifically for BoxLang, making it the ideal option for:

  • High-traffic applications
  • Mission-critical systems
  • Enterprise-grade scalability
  • Secure production environments

And of course… it includes the iconic ASCII art. 😉


🏢 Enterprise Features with BoxLang Subscriptions

With BoxLang+ and BoxLang++, you automatically unlock CommandBox PRO, giving you access to advanced enterprise capabilities:

  • 🏠 Multi-site Support – Host several apps on one CommandBox instance
  • 🔐 Multi-SSL & SNI – Fully managed SSL certificates
  • ⚙️ OS Service Manager – Run CommandBox as a system service
  • 🛡️ CAC Authentication – Enterprise-level security integration
  • ☕ JDK Management – Built-in Java version handling
  • 📊 Advanced Monitoring & Metrics
  • 🔧 Professional Support – Direct from Ortus engineers

If you’re running BoxLang in Enterprise environments, these tools are game-changing.


🐳 Docker-Ready Deployment

CommandBox also ships with official Docker images, ready for cloud-native workflows:

# Pull the official CommandBox Docker image
docker pull ortussolutions/commandbox

# Run a BoxLang server
docker run -d \
  -p 8080:8080 \
  -v /path/to/your/app:/app \
  ortussolutions/commandbox

Perfect for Kubernetes, Docker Swarm, ECS, Nomad, or any container platform.


📦 Installing BoxLang Support in CommandBox

Until CommandBox 6.1+ ships with BoxLang built-in, simply install the module:

install commandbox-boxlang

This adds all required handlers and file type support.


🚀 Starting a BoxLang Server

Once installed, starting a server is beautifully simple:

server start cfengine=boxlang javaVersion=openjdk21_jdk

Additional options for enterprise environments:

# JVM tuning
server start cfengine=boxlang --jvmArgs="-Xmx2g -Xms1g"

# SSL
server start cfengine=boxlang port=8443 SSL=true

# Debug mode
server start cfengine=boxlang --debug

# Production
server start cfengine=boxlang profile=production

📂 Server Home & Module Management

CommandBox automatically manages BoxLang server homes.

You can easily install modules:

install bx-mysql,bx-derby
install bx-mail@1.0.0
install github:ortus-boxlang/bx-elasticsearch

Everything goes where it should—no manual setup needed.


⚙️ Enterprise server.json

Here’s a clean, portable example:

{
  "name": "MyBoxLang-Server",
  "app": {
    "cfengine": "boxlang",
    "serverHomeDirectory": ".boxlang"
  },
  "web": {
    "rewrites": { "enable": true }
  },
  "jvm": {
    "heapSize": "2048m"
  },
  "scripts": {
    "onServerInitialInstall": "install bx-mail,bx-mysql,bx-derby,bx-compat-cfml"
  }
}

And a production-hardened version:

{
  "name": "BoxLang-Production-Server",
  "app": {
    "cfengine": "boxlang",
    "serverHomeDirectory": "/opt/boxlang-server"
  },
  "web": {
    "host": "0.0.0.0",
    "SSL": {
      "enable": true,
      "port": 8443,
      "certFile": "/etc/ssl/server.crt",
      "keyFile": "/etc/ssl/server.key"
    }
  },
  "jvm": {
    "heapSize": "4096m"
  }
}


🔧 Debugging BoxLang in CommandBox

Enable debug mode through:

server start --debug

Or in server.json:

"env": { "BOXLANG_DEBUG": true }

Or via .env:

BOXLANG_DEBUG=true

Or via .cfconfig.json:

{ "debuggingEnabled": true }

You choose your workflow.


📚 Resources

  • Official CommandBox Runtime: GitHub (boxlang-servlet)
  • CommandBox Docker Hub
  • BoxLang Plans (BoxLang+ and BoxLang++)
  • Standalone CommandBox PRO

🎁 Day 2 Wrap-Up

CommandBox + BoxLang is more than a deployment stack — it’s an enterprise-grade runtime ecosystem.

From CLI productivity to containerization, SSL, monitoring, and professional support, CommandBox is the most powerful and flexible way to run BoxLang in production.

Stay tuned for Day 3 of our 12 Days of Christmas Series! 🎄✨


Want to Join the BoxLang Modern World?

Become a Pioneer

BoxLang is growing fast features are expanding, the ecosystem is thriving, and performance is turning heads. But the most exciting part? You can be part of shaping it from the very beginning.

The Pioneer Program is your gateway to early access, unmatched support, and unbeatable value. Here’s what you get:

  1. Everything in BoxLang+, and more:
    • Professional support to get you running smoothly
    • A dedicated Slack channel for direct access to our team, solve issues in seconds
    • Priority handling for your feature requests and bug fixes
  2. Migration done with you, not just for you:
    • Our engineers work alongside your team to migrate your apps end-to-end
    • Guaranteed compatibility, we won’t stop until it works perfectly
  3. Big savings, no hidden tricks:
    • At least 40% off your current licensing costs, locked in early, no surprise charges as you grow

Request more Info


Still Not Convinced?

If you’re unsure how BoxLang will work with your applications, or whether it can truly make a difference, we’ve made it easy to see the value for yourself, risk-free:

  1. Free 30-Minute Consultation & App Diagnosis

    We’ll review your applications, identify bottlenecks, and give you a clear modernization plan. You’ll see exactly where you can save time, reduce costs, and unlock new possibilities with BoxLang.

  2. 1-Year Free Non-Production License

    Test-drive BoxLang Premium features in your own environment, no rush, no pressure. Explore advanced capabilities, experiment freely, and experience the benefits firsthand before making any commitments.

Contact Us


Join the BoxLang Community

Stay connected with the latest updates, BoxLang announcements, Into the Box 2026 news, tutorials, tools, and more.

Subscribe to our newsletter for exclusive updates and early access.

Follow Us

Add Your Comment

Recent Entries

BoxLang AI 3.7: Profiles, Embeddings Defaults and MCP Rate Limiting

BoxLang AI 3.7: Profiles, Embeddings Defaults and MCP Rate Limiting

Ortus Solutions announces the release of BoxLang AI 3.7. Name a provider, model, params and API key once, then pick it by name for a call, an agent, or a single agent run. Embeddings get their own defaults, MCP servers you build get rate limiting and trusted proxies, and a handful of important fixes land along the way.

Luis Majano
Luis Majano
November 05, 2026
BoxLang  1.19.0: See Everything Your Code Does

BoxLang 1.19.0: See Everything Your Code Does

Ortus Solutions today announces the release of BoxLang 1.19.0, the software productivity platform for building, modernizing and running applications, with developers and AI agents working together. This release is about observability: built-in code coverage and execution profiling, the missing post-invocation events for BIFs, and new query and transaction events, and it pairs with the new BxLens beta, the debug bar and ops console that exposes hotspots and bytecode profilers. It also adds your own global settings in boxlang.json, static method interception, raw binary HTTP streaming and a lot of hardening across JDBC, Java interop and CFML compatibility.

Luis Majano
Luis Majano
November 05, 2026
Build AI Agents with Less Configuration: Join Luis Majano in Málaga

Build AI Agents with Less Configuration: Join Luis Majano in Málaga

Learn how to define, build, and run AI agents with BxAgents in a hands-on session organized by Malaga-AI and sponsored by Ortus Solutions! 🚀

Building an AI agent means connecting instructions, models, tools, and application logic. A clear project structure makes those pieces easier to organize and develop.

Maria Jose Herrera
Maria Jose Herrera
November 04, 2026