boxlang-runtime-miniserver

Configure and run a BoxLang MiniServer with Undertow-based runtime settings.

16|78|Updated Nov 28, 2014

Search Tags:#configuration #health-check #webserver #warmup #boxlang #miniserver #undertow

Ready to run

npx skills add https://github.com/ortus-docs/coldbox-docs --skill boxlang-runtime-miniserver

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: boxlang-runtime-miniserver
Source: https://github.com/ortus-docs/coldbox-docs/tree/main/.agents/skills/boxlang-runtime-miniserver
Command: npx skills add https://github.com/ortus-docs/coldbox-docs --skill boxlang-runtime-miniserver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run BoxLang MiniServer to provide a fast, lightweight Undertow-based runtime for BoxLang applications, with simple configuration and project conventions.

Core Features & Use Cases

Lightweight Undertow-based runtime for BoxLang apps.
Configures via miniserver.json and the .boxlang.json project convention.
Supports health checks, warmup URLs, and environment variable overrides for development and production deployments.
Suitable for development servers and production deployments that do not require a full Java EE container.

Quick Start

Start BoxLang MiniServer in the project directory to serve your application with the default port and webroot.

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 with a lightweight web server?▼

Run a BoxLang application using the MiniServer, a lightweight Undertow-based runtime that serves apps via simple project conventions without needing a full Java EE container.

How do I configure ports and webroot for a BoxLang MiniServer?▼

Configure the BoxLang MiniServer by defining webroot, ports, and rewrites in a miniserver.json file or the .boxlang.json project convention, with support for environment variable overrides.

Does the BoxLang MiniServer support health checks and warmup URLs for production?▼

Yes, the BoxLang MiniServer supports health checks and warmup URLs, making it suitable for both development servers and production deployments that require lightweight runtime monitoring.

Can I use environment variables to override BoxLang MiniServer configuration?▼

Yes, you can use environment variables to override BoxLang MiniServer settings defined in miniserver.json and .boxlang.json, enabling flexible configuration across different deployment environments.

When should I use a BoxLang MiniServer instead of a full Java EE container?▼

Use the BoxLang MiniServer for development or production deployments requiring a fast, lightweight Undertow-based runtime, avoiding the overhead of a full Java EE container.

Why is my BoxLang web server not picking up project conventions?▼

The BoxLang MiniServer reads configuration from miniserver.json and the .boxlang.json project convention file, so ensure these files exist in your project directory and are correctly formatted.