> ## 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 github base-image list

List available GitHub runner base images.

`nsc github base-image list` shows the base images that Namespace provides for GitHub Actions runners, together with their labels and image references. Use [nsc github base-image describe](/docs/reference/cli/github-base-image-describe) to see the full contents of a specific image.

## Usage

```bash theme={null}
nsc github base-image list [flags]
```

### Examples

**List all base images:**

```bash theme={null}
nsc github base-image list
```

**List base images as JSON:**

```bash theme={null}
nsc github base-image list -o json
```

**Filter by label:**

```bash theme={null}
nsc github base-image list --label ubuntu-24.04 --label ubuntu-26.04
```

## Optional Flags

<h3 id="-o---output-string">
  -o, --output string
</h3>

Output format. Default: `plain`.

Supported values: `plain`, `json`.

<h3 id="--label-stringarray">
  \--label stringArray
</h3>

Filter by label (for example `ubuntu-24.04`). Can be specified multiple times.

<h3 id="--include-canary">
  \--include-canary
</h3>

Include canary images in the output.

## Related Topics

* [nsc github base-image describe](/docs/reference/cli/github-base-image-describe) - Show details for a specific base image