boxlang-runtime-miniserver

Launch BoxLang applications with a lightweight Undertow-based MiniServer.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BoxLang MiniServer provides a lightweight Undertow-based runtime to run BoxLang applications, enabling development servers and streamlined deployments with miniserver.json and .boxlang.json project conventions, including health checks and warmups.

Core Features & Use Cases

  • Lightweight web runtime for BoxLang apps
  • Health checks, warmups, and environment variable overrides
  • Easy deployment for development and staging environments

Quick Start

Start the mini server in the current project with the default settings by running boxlang-miniserver.

Frequently Asked Questions about boxlang-runtime-miniserver

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

FAQPage Schema
How do I run a BoxLang application using a lightweight web server?

Run a BoxLang application in a lightweight web server by launching the Undertow-based MiniServer, which uses miniserver.json and .boxlang.json conventions to configure local development and production-like testing environments.

How do I configure health checks and warmup URLs for a BoxLang web server?

Configure health checks and warmup URLs for a BoxLang web server by defining the settings in your miniserver.json file, which the MiniServer reads at launch to manage deployment readiness and application preloading.

Can I use environment variables to override BoxLang MiniServer configuration?

Yes, you can use environment variables to override BoxLang MiniServer configuration values, allowing you to dynamically adjust Undertow parameters and application settings without modifying the miniserver.json file directly.

What is the best way to test BoxLang apps locally with an Undertow server?

The best way to test BoxLang apps locally with an Undertow server is using the MiniServer runtime, which enforces project conventions via miniserver.json and provides tunable Undertow parameters for performance testing.

Does the BoxLang MiniServer support staging and development deployments?

Yes, the BoxLang MiniServer supports staging and development deployments by providing a lightweight Undertow-based runtime that streamlines configuration and enables health checking for production-like environments.

Do I need miniserver.json to start a BoxLang development server?

Yes, miniserver.json is required to start a BoxLang development server because the MiniServer enforces configuration through this file, using it to define warmup URLs, health checks, and Undertow parameters.