Skip to content
Hoplite
◐Theme

Begin typing to search this site.

Production operation

Foreground operation

Section titled “Foreground operation”
Terminal window
hoplite serve check --mode prod PROJECT
hoplite serve build --mode prod PROJECT
hoplite serve foreground --mode prod PROJECT

Production mode uses available CPU parallelism unless the selected profile or advanced host configuration specifies a worker count. It does not expose the development-only default OpenAPI route.

Foreground operation also starts the Hoplite management gateway on 127.0.0.1:9090. Set HOPLITE_MANAGEMENT_LISTEN to another loopback socket, or to off when a separate hoplite auth serve process owns management. Non-loopback values are rejected.

Managed background process

Section titled “Managed background process”
Terminal window
hoplite serve start --mode prod PROJECT
hoplite serve status PROJECT
hoplite serve reload PROJECT
hoplite serve stop PROJECT

macOS LaunchAgent

Section titled “macOS LaunchAgent”
Terminal window
hoplite serve install --mode prod PROJECT
hoplite serve uninstall PROJECT

install and uninstall require macOS launchd. They are not supported on Linux.

Logs and process files

Section titled “Logs and process files”

The built Nginx configuration places the PID, access log, and error log inside the project’s .hoplite/ directory. Use the development console’s dev/logs when the application is owned by that console.