boxlang-runtime-dockerlisted
Install: claude install-skill ortus-boxlang/skills
# BoxLang with Docker
## Overview
BoxLang ships three official Docker images for different use cases: a headless
CLI image, a MiniServer web runtime, and a MiniServer + Nginx reverse-proxy
image. All images are available in Debian (default) and Alpine (`-alpine`) flavors
and as nightly snapshots (`-snapshot`).
---
## Image Reference
| Image | Purpose | Default port |
|-------|---------|-------------|
| `ortussolutions/boxlang:cli` | Run scripts, REPL, batch jobs | — |
| `ortussolutions/boxlang:miniserver` | Standalone web server | 8080 |
| `ortussolutions/boxlang:miniserver-nginx` | Web server + Nginx reverse proxy | 80 |
### Variants
| Suffix | Description |
|--------|-----------|
| _(none)_ | Debian base |
| `-alpine` | Alpine Linux — smaller image (~50% smaller) |
| `-snapshot` | Latest nightly snapshot build |
---
## CLI Image
### Run a Script
```bash
docker run --rm \
-v "$(pwd):/scripts" \
ortussolutions/boxlang:cli \
boxlang /scripts/myscript.bxs
```
### Open an Interactive REPL
```bash
docker run --rm -it ortussolutions/boxlang:cli boxlang
```
### Pass Variables via CLI
```bash
docker run --rm \
-e MY_VAR=hello \
-v "$(pwd):/scripts" \
ortussolutions/boxlang:cli \
boxlang /scripts/greet.bxs
```
---
## MiniServer Image
The MiniServer image serves a BoxLang web application from `/app` on port 8080.
### Basic Usage
```bash
docker run --rm \
-p 8080:8080 \
-v "$(pwd)/src:/app" \
ortussolutions/boxlang:miniserver
```
### Install Mod