boxlang-runtime-miniserverlisted
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