← ClaudeAtlas

boxlang-runtime-miniserverlisted

Use this skill when running BoxLang as a lightweight web server using the BoxLang MiniServer (Undertow-based), configuring miniserver.json, using the .boxlang.json project convention, enabling health checks, warmup URLs, environment variable overrides, and tuning for development and production.
ortus-boxlang/skills · ★ 0 · DevOps & Infrastructure · score 58
Install: claude install-skill ortus-boxlang/skills
# BoxLang MiniServer ## Overview BoxLang MiniServer is the official lightweight web server for BoxLang applications. It is built on **Undertow** and is NOT a servlet container — it is a purpose-built, fast web runtime for BoxLang. Use it for development servers and production deployments where a full Java EE container is not needed. Binary: `boxlang-miniserver` (Windows: `boxlang-miniserver.bat`) Default behavior: binds `0.0.0.0:8080`, uses current working directory as webroot. --- ## Quick Start ```bash # Start in current directory on default port 8080 boxlang-miniserver # Custom port and webroot boxlang-miniserver --port 9000 --webroot ./public # Enable URL rewrites (SPA or front-controller pattern) boxlang-miniserver --rewrites # Production with health checks boxlang-miniserver --port 8080 --health-check --health-check-secure ``` --- ## CLI Flags | Flag | Short | Description | |------|-------|-------------| | `--port <n>` | `-p` | Port to bind (default: 8080) | | `--host <ip>` | | Host/IP to bind (default: `0.0.0.0`) | | `--webroot <path>` | `-w` | Webroot directory (default: CWD) | | `--debug` | `-d` | Enable debug mode | | `--rewrites` | `-r` | Enable URL rewrites to `index.bxm` | | `--configPath <path>` | `-c` | Path to JSON config file | | `--serverHome <path>` | `-s` | Override server home directory | | `--health-check` | | Enable health check endpoints | | `--health-check-secure` | | Secure health checks (details localhost-only) | | `--version` | | Print