Skip to main content

Build an image from a Dockerfile

POST 
/v1/build

The request body is the build context as a tar archive (optionally gzip-compressed). nyx build creates it from a directory, honouring .dockerignore.

The response streams application/x-ndjson: {"stream": "..."} lines with step headers and RUN output, then either {"done": true, "image_id": "sha256:...", "tags": [...]} or {"error": "..."}. A client disconnect cancels the build.

RUN steps execute in the container sandbox (same seccomp, capabilities, and user namespace when rootless) with the host network. See docs/build.md.

Request​

Responses​

NDJSON build progress stream