Local Development Setup¶

Run the full Engine stack locally with Docker Compose.

Start the Stack¶

cd engine
docker-compose up -d

Verify Services¶

curl http://localhost:8080/v1/status
curl http://localhost:8083/healthz

Common Local Ports¶

Gateway: 8080
Orchestrator: 8083
Transformers: 8081
Storage: 8086
Identity: 8088
RabbitMQ UI: 15672

Reload Runtime Artifacts¶

After editing workflow files, reload orchestrator runtime:

curl -X POST http://localhost:8083/admin/reload \
    -H "X-Reload-Token: <reload-token>"

Template artifact files: - Place xslt_file / template_file assets under flows/artifacts/. - Kubernetes deployments mount shared flows data under /app/flows. - Runtime resolution is controlled by WORKFLOW_ARTIFACTS_DIR.

For Kubernetes environments using the artifacts PVC, sync files after updates:

./scripts/sync-flows-pv.sh meshflows

Troubleshooting¶

Check logs:

docker-compose logs -f orchestrator
docker-compose logs -f gateway

Rebuild after dependency changes:

docker-compose build
docker-compose up -d