---
title: "axiom build"
description: "Build a local Docker image identical to the publish pipeline"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, guides/create-a-node-python, guides/create-a-node-go, guides/create-a-node-typescript, guides/create-a-node-rust, guides/create-a-node-java, guides/create-a-node-csharp]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom build

Build a local Docker image identical to the publish pipeline

Full local reproducible build — identical artifacts to the publish pipeline.

Steps:
```text
1. Compile proto bindings  (axiom generate)
2. Validate package        (axiom validate)
3. Generate gRPC service   (.axiom/service.<ext>)
4. Generate Dockerfile     (.axiom/Dockerfile)
5. Assemble build context  (.axiom/image/)
6. Build Docker image      (docker build)
```

All artifacts are written to .axiom/ and are fully inspectable.

## Usage

```sh
axiom build [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for build |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- Guide: [Create a node (Python)](../../guides/create-a-node-python.md)
- Guide: [Create a node (Go)](../../guides/create-a-node-go.md)
- Guide: [Create a node (TypeScript)](../../guides/create-a-node-typescript.md)
- Guide: [Create a node (Rust)](../../guides/create-a-node-rust.md)
- Guide: [Create a node (Java)](../../guides/create-a-node-java.md)
- Guide: [Create a node (C#)](../../guides/create-a-node-csharp.md)