Directory Structure

Create a directory under frameworks/ with your framework’s name:

frameworks/
  your-framework/
    Dockerfile
    meta.json
    ... (source files)

Dockerfile

The Dockerfile should build and run your server. Containers are started with --network host, so bind to:

• Port 8080 — HTTP/1.1
• Port 8443 — HTTPS with HTTP/2 and HTTP/3 (if supported)

Example (Go):

FROM golang:1.22-alpine AS build
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o server .

FROM alpine:3.19
COPY --from=build /app/server /server
CMD ["/server"]

Mounted volumes

The benchmark runner mounts these paths into your container (read-only):

Postgres (profiles async-db, crud, api-4, api-16, and the compose-orchestrated gateway + production-stack) is provided by a separate sidecar container, reachable via the DATABASE_URL environment variable — not a mount. Redis (profile crud) is similarly reachable via REDIS_URL. See Configuration for the full env var list.