# CommandBox

CommandBox is a versatile tool used to run and manage web applications built with BoxLang or CFML. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5473/commandbox

## Description

CommandBox is a versatile tool used to run and manage web applications built with BoxLang or CFML. It simplifies the setup process, allowing you to launch and control your apps quickly and reliably within a secure, self-hosted environment.

## Platform availability

Available on 0 of 10 platforms.

## Health score

67/100 (Good), based on 5 of 5 factors.
- Maintained: 95 (last commit 52 days ago)
- Popular: 44 (150 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 100 (256 MB minimum RAM, runs on ARM)
- Security check: 55 (no serious findings, 5 minor, tests)

## Links

- Docker Hub: https://hub.docker.com/r/ortussolutions/commandbox
- Official website: https://commandbox.ortusbooks.com/
- GitHub: https://github.com/Ortus-Solutions/commandbox

## Common questions

### How do I expose a CommandBox Docker app and point it at my project files?

Map port 8080 and mount your project folder at /app in the container. Without the port mapping your browser cannot reach the app, and without the /app mount it will not see your files.

### Why might a docker-commandbox container start but the application still fail?

Enable BOX_INSTALL or run box install before the server starts so box.json dependencies are installed. If you skip this, the container may start but the app can fail because required packages are missing.

### How do I choose the CFML engine used by docker-commandbox?

Set BOX_SERVER_APP_CFENGINE to the engine you want, such as lucee@6, boxlang@1.14.0, or adobe@2025, and run the warmup script. This tells CommandBox which runtime to load so it does not start with the wrong or missing engine.

### Why is the Lucee admin page unavailable after spinning up a CommandBox container?

The default server profile is production, which disallows access to the Lucee admin pages when accessing from anything other than localhost.

---
Source: Our Local Host (https://ourlocalhost.com/app/5473/commandbox), the self-hosted and open-source app directory.
