> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# nsc build logs

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

```bash theme={null}
nsc build logs <build-ref> [-o <plain|json>]
```

### Example

```bash theme={null}
nsc build logs <build-ref>
```

To fetch the raw BuildKit JSON status stream instead:

```bash theme={null}
nsc build logs <build-ref> --output json
```

## Options

<h3 id="--output--o-plainjson">
  \--output, -o \<plain|json>
</h3>

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`.

## Related Topics

* [nsc build](/docs/reference/cli/build) - Build container images using Namespace Remote Builders