Deployment
Production build, Docker, BoxLang MiniServer, and a go-live checklist.
Deployment
Production build
npm run build
Compiles and fingerprints the frontend into public/includes/ - see Frontend.
Docker
A Dockerfile and docker-compose.yml live in resources/docker/. The docker:* package scripts run Docker directly; they do not replace the required BoxLang CLI installation for local box commands.
npm run docker:build
npm run docker:stack -- up -d
Build the frontend before creating a production image:
npm run build
BoxLang MiniServer
An alternative to the bx-cli development server for running the compiled app directly:
cd my-app
boxlang-miniserver --port 8080 --webroot ./public --dev
The MiniServer does not provide box install, migrations, or TestBox commands. Use the required BoxLang CLI for those tasks.
Production checklist
ENVIRONMENT=production and BOXLANG_DEBUG=false in .env.
Point app/config/modules/cbmailservices.bx at a real SMTP/Postmark/SendGrid driver - see Email.
The seeder creates admin@cbgenesis.com / test - change it immediately after your first login. See Getting Started.
In app/config/Coldbox.bx, so framework reinit (?fwreinit=true) isn't left open to anyone.
Via SSL configuration in server.json, or your reverse proxy / load balancer of choice.
npm run build for minified, fingerprinted assets.
Remove or restrict the public /healthcheck endpoint if it shouldn't be reachable from outside your infrastructure.