CFDL

Run the API server

cfdl-server is a self-hostable HTTP API over the compiler and engine — filesystem-free, embedded packs only.

This page covers running it. For the endpoints it exposes, see API server.

Docker

docker run -p 8080:8080 ghcr.io/cfdl-dev/cfdl-server:latest

Every release publishes the image under its version tag as well (ghcr.io/cfdl-dev/cfdl-server:<version>); pin one in production.

From source

cargo run --release -p cfdl-server

Configuration

  • CFDL_SERVER_ADDR — bind address (default 0.0.0.0:8080).
  • Built-in limits: 1 MiB request body, 10 s request timeout, Monte Carlo trials capped at 1000 (rejected, never truncated).

Verify

curl localhost:8080/healthz          # {"status":"ok"}
open http://localhost:8080/docs      # Swagger UI

Next: API endpoints and usage