---
title: "ktm dashboards build"
description: "Use ktm dashboards build to atomically create dashboards with all widgets validated upfront and auto-positioned, previewing layouts via dry-run."
sidebarTitle: "build"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Create a dashboard with all widgets atomically

## Usage

```bash
ktm dashboards build [flags]
```

## Examples

```bash
# Build a dashboard (dry-run)
ktm dashboards build --operator my-op --name "SLA" --widgets widgets.json --dry-run

# Build for real
ktm dashboards build --operator my-op --name "SLA" --widgets widgets.json

# With bucket
ktm dashboards build --operator my-op --name "Passive" --widgets w.json --bucket my-bucket
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--bucket` | string |  | InfluxDB bucket (optional) |
| `--dry-run` | boolean |  | Preview layout without creating the dashboard |
| `--name` | string |  | Dashboard name (required) |
| `--operator` | string |  | Operator slug (required) |
| `--widgets` | string |  | JSON file with widget array (required) |

## Details

Create a dashboard with all widgets in a single atomic call.
Validates all widgets upfront — if ANY fails, NONE are created.
Auto-positions widgets using type defaults.

Use --dry-run to preview the ASCII grid layout without creating anything.

## Related

- [`ktm dashboards`](/cli/commands/dashboards)

<Note>
  Global flags (`--output`, `--debug`, `--host`, …) apply to every command. See the [command reference overview](/cli/commands/overview).
</Note>

## What's next?

<Columns cols={2}>
  <Card title="All commands" icon="terminal" href="/cli/commands/overview">
    Browse the full CLI reference.
  </Card>
  <Card title="Get started" icon="rocket" href="/cli/getting-started">
    Install the CLI and authenticate.
  </Card>
</Columns>