Skip to main content
Print logs for a build. nsc build logs prints the logs produced by a specific nsc build invocation, identified by its build reference (<build-ref>). It’s useful when you want to inspect the output of a build that’s still running, or one that already finished, without needing to keep the original terminal session open. By default, logs are printed in a human-readable plain format. Passing --output json instead streams the raw BuildKit status events as one JSON object per line, which is convenient if you want to feed the build’s log output into another tool for processing.

Usage

Example

To fetch the raw BuildKit JSON status stream instead:

Options

—output, -o <plain|json>

Specifies the output format. Supported values are plain and json; json prints the raw BuildKit status stream as one JSON object per line. Defaults to plain.
  • nsc build - Build container images using Namespace Remote Builders
Last modified on August 20, 2026