boxlang-deploymentlisted
Install: claude install-skill ortus-boxlang/skills
# BoxLang Deployment
## Overview
BoxLang applications can be deployed across multiple runtimes: embedded web servers
(CommandBox/MiniServer), Docker containers, serverless (AWS Lambda, Google Cloud
Functions, Azure), Spring Boot, and even WASM. JRE 21+ is required for all deployments.
## Requirements
- **JRE 21+** (or OpenJDK 21+) is required
- **CommandBox** is the recommended deployment tool for traditional servers
- **BVM** (BoxLang Version Manager) manages BoxLang versions per project
---
## CommandBox (Recommended for Traditional Servers)
### Installation
```bash
# Install CommandBox (macOS)
brew install commandbox
# Linux
curl -fsSl https://downloads.ortussolutions.com/debs/gpg | apt-key add -
echo "deb https://downloads.ortussolutions.com/debs/noarch /" >> /etc/apt/sources.list.d/commandbox.list
apt-get install commandbox
# Install BoxLang engine in CommandBox
box install commandbox-boxlang
```
### Start a Server
```bash
# Simple start
box server start cfengine=boxlang javaVersion=openjdk21_jdk
# With port
box server start cfengine=boxlang port=8080
# Start with server.json
box server start
```
### `server.json` Configuration
```json
{
"name": "myapp-production",
"web": {
"http": {
"port": 8080,
"enable": true
},
"https": {
"port": 8443,
"enable": true,
"certFile": "/certs/myapp.crt",
"keyFile": "/certs/myapp.key"
},
"webroot": "www",