commandbox-embedded-server

Start, stop, and configure CommandBox embedded Undertow servers for BoxLang apps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating the lifecycle and configuration of a CommandBox embedded Undertow server for BoxLang applications, eliminating manual setup and ad-hoc server runs.

Core Features & Use Cases

  • Start, stop, restart servers directly from project roots with sensible defaults and optional port specification.
  • Configure server.json for application, JVM, and web settings (bindings, SSL, rewrites, profiles, and multi-site hosting) with production/development environments.
  • Inspect logs, server info, and apply security rules, basic auth, and alias mappings to simplify local development and testing.

Quick Start

Run the embedded server from your project directory to start a server with sensible defaults and auto port selection.

Frequently Asked Questions about commandbox-embedded-server

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

FAQPage Schema
How do I start a CommandBox embedded Undertow server for a BoxLang app?

Start the embedded Undertow server directly from your BoxLang project root directory to launch with sensible defaults and automatic port selection. This eliminates manual setup by applying configuration from your server.json file directly to the local server context.

How do I configure JVM arguments and SSL/TLS for a CommandBox server?

Configure JVM arguments and SSL/TLS by defining web settings, bindings, and environment profiles within your server.json file. This approach supports both development and production contexts while ensuring safe defaults and isolated server contexts for your BoxLang application.

Can I manage multiple site hostings on a single CommandBox embedded server?

Yes, you can manage multi-site hosting by configuring alias mappings and bindings within your server.json file. This allows the embedded Undertow server to route multiple sites across distinct development and production profiles from a single project configuration.

What is the best way to apply URL rewrites and basic auth in CommandBox?

The best way to apply URL rewrites and basic auth is by defining security rules and web settings inside your server.json file. This automates the configuration of the embedded Undertow server, simplifying local development and testing workflows safely.

Does managing an embedded server require manually stopping and starting processes?

No, managing an embedded server does not require manual process handling because the Skill automates the complete server lifecycle. It handles starting, stopping, and restarting the Undertow server directly while applying isolated server contexts and safe defaults.

Why use server.json profiles for development and production environments?

Using server.json profiles separates development and production environment configurations for your BoxLang apps. This ensures distinct JVM arguments, SSL/TLS bindings, and web settings apply safely per environment without ad-hoc server runs or manual overrides.