---
title: assemble cli command
description: Clone all repositories and build the unified documentation site in one step. The assembler clones multiple documentation repositories and builds them...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2927/cli/assemble
products:
  - Elastic Docs Builder
---

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

Clone all repositories and build the unified documentation site in one step.

## Options

<definitions>
  <definition term="--[no-]strict">
    Treat warnings as errors.
  </definition>
  <definition term="--environment string">
    Named deployment target, e.g. dev, staging, production. Determines which configuration branch and index names are used.
  </definition>
  <definition term="--[no-]metadata-only">
    Write only metadata files; skip HTML generation. Ignored when --exporters is also set.
  </definition>
  <definition term="--[no-]show-hints">
    Print documentation hints emitted during the build.
  </definition>
  <definition term="--exporters string">
    Comma-separated list of exporters to run.
  </definition>
  <definition term="--[no-]assume-build">
    Skip the build step when .artifacts/docs/index.html already exists. Intended for test scenarios only.
  </definition>
  <definition term="--[no-]fetch-latest">
    Fetch the HEAD of each branch instead of the pinned link-registry ref.
  </definition>
  <definition term="--[no-]assume-cloned">
    Skip cloning; assume repositories are already on disk. Useful for iterating on the build.
  </definition>
  <definition term="--[no-]serve">
    Serve the site on port 4000 after a successful build.
    **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>


## Notes

The assembler clones multiple documentation repositories and builds them into a single unified site
composed by a shared navigation.yml. This command combines assembler config init,
assembler clone, and assembler build into a single invocation.