---
title: build cli command
description: Build a single documentation set from source. 
url: https://docs-v3-preview.elastic.dev/docs-builder/cli/build
products:
  - Elastic Docs Builder
---

# build cli command
```bash
docs-builder build [options]
```

<cli-modifiers>
</cli-modifiers>

Build a single documentation set from source.

## Options

<definitions>
  <definition term="-p --path string">
    Root directory of the documentation source. Defaults to cwd/docs.
    **Constraints:** symbolic links not allowed, must exist, supports `~` home expansion
  </definition>
  <definition term="-o --output string">
    Destination for generated HTML. Defaults to .artifacts/html.
    **Constraints:** symbolic links not allowed, supports `~` home expansion
  </definition>
  <definition term="--path-prefix string">
    URL path prefix prepended to every generated link.
  </definition>
  <definition term="--[no-]force">
    Delete and rebuild the output folder even if nothing changed.
  </definition>
  <definition term="--[no-]strict">
    Treat warnings as errors.
  </definition>
  <definition term="--[no-]allow-indexing">
    Emit meta robots tags that allow search engine indexing.
  </definition>
  <definition term="--[no-]metadata-only">
    Write only metadata files; skip HTML generation. Ignored when --exporters is also set.
  </definition>
  <definition term="--exporters string">
    Comma-separated list of exporters to run.
  </definition>
  <definition term="--canonical-base-url string">
    Base URL written into <link rel=canonical> tags.
    **Constraints:** must be a http or https URI
  </definition>
  <definition term="--[no-]skip-api">
    Skip OpenAPI spec generation for faster builds.
  </definition>
  <definition term="--[no-]skip-cross-links">
    Skip fetching cross-doc-set link indexes.
  </definition>
  <definition term="--[no-]in-memory">
    **Default:** `false`
  </definition>
  <definition term="-l --log-level enum">
    Minimum log level.
    **Values:** trace, debug, information, warning, error, critical, none
    **Default:** `information`
  </definition>
  <definition term="-c --config-source enum">
    Override the configuration source: local, remote
    **Values:** local, remote, embedded
  </definition>
  <definition term="--[no-]skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>