commandbox-deploying

Deploy CommandBox applications to production using Docker, GitHub Actions, and CFConfig.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying CFML/BoxLang applications to production can be challenging without a repeatable deployment strategy, leading to configuration drift and manual errors.

Core Features & Use Cases

  • Reproducible deployments using server.json across Docker, cloud environments, and OS services.
  • Docker-based deployment with containerized runtimes and environment variable configuration.
  • GitHub Actions integration via setup-commandbox for automated CI/CD pipelines.
  • CFConfig integration for engine configuration management and consistent server settings.
  • Start-up and service deployment scenarios including systemd, Heroku/Dokku, and Lightsail bootstrap.

Quick Start

Configure a server.json and select a deployment target (Docker, OS service, or cloud) to launch production-ready BoxLang apps.

Frequently Asked Questions about commandbox-deploying

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

FAQPage Schema
How do I deploy a CommandBox application to production using Docker?

Deploy CommandBox applications to production using Docker by configuring a server.json file and utilizing containerized runtimes with environment variables. This approach ensures reproducible deployments and prevents configuration drift across cloud environments.

Can I use GitHub Actions to automate CommandBox deployments?

Yes, GitHub Actions automates CommandBox deployments via the setup-commandbox integration for CI/CD pipelines. This enables reproducible builds and automated releases for CFML/BoxLang apps requiring consistent delivery workflows.

What is the best way to manage server configuration when deploying CFML apps?

Managing server configuration when deploying CFML apps is best handled through CFConfig integration. It ensures consistent engine settings across Docker, cloud environments, and OS services by externalizing configuration from the deployment artifact.

Does CommandBox support deploying apps as systemd services?

Yes, CommandBox supports OS service deployment scenarios including systemd. This allows CFML/BoxLang applications to run reliably as background services on Linux servers using configurations defined in server.json.

How do I configure environment variables for a CommandBox Docker container?

Configure Docker environment variables for a CommandBox container by defining them in your Docker runtime configuration. The server.json file captures baseline settings, while environment variables override and inject dynamic values at startup.

Why do I need server.json for reproducible production deployments?

You need server.json for reproducible production deployments because it defines the runtime configuration, port settings, and JVM arguments in a single file. This prevents manual configuration errors and ensures consistency across Docker, cloud, and systemd targets.