Run the binary directly
You can also run the binary yourself (the same one the plugin installs), configuring it entirely through environment variables:
NANOBPMN_DATA_DIR=/var/lib/nanobpmn PORT=8080 ./nanobpm-gateway-rest-server
On startup it prints the URLs it serves:
Nano BPM is up:
Landing page http://127.0.0.1:8080/
Web console http://127.0.0.1:8080/console
API reference http://127.0.0.1:8080/swagger
REST API http://127.0.0.1:8080/v2
Metrics http://127.0.0.1:8080/metrics
The most common settings:
| Variable | Effect |
|---|---|
PORT=<n> |
HTTP listen port (default 8080). |
NANOBPMN_DATA_DIR=<dir> |
Durable data directory (event log + read model). Without it, the server runs fully in-memory and loses everything on exit. Set it for anything you want to keep. |
NANOBPMN_WORKSPACE_DIR=<dir> |
Where the console stores your projects and workers (default ./nanobpm-workspace; projects live under <workspace>/projects/ by default, unless NANOBPMN_PROJECTS_DIR moves them). Survives deletion of the engine data dir. |
NANOBPMN_PROJECTS_DIR=<dir> |
Advanced: override the projects root directly (default <workspace>/projects). |
DEBUG_REST=1 |
Log every REST request/response (method, URI, status, latency). Leave off in production. |
The clustering and tuning variables are covered in Run a cluster and Tune durability and performance.