---
title: assembler deploy plan cli command
description: Creates an incremental synchronization plan by comparing the remote --s3-bucket-name with the local output of the build. Remote files that are no longer...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4493/cli/assembler/deploy/plan
products:
  - Elastic Docs Builder
---

# assembler deploy plan cli command
<cli-modifiers>
</cli-modifiers>

```bash
docs-builder assembler deploy plan \
  --environment <string> \
  --s3-bucket-name <string> \
  [options]
```

Creates an incremental synchronization plan by comparing the remote `--s3-bucket-name` with the local output of the build.
Remote files that are no longer in the build output are planned for deletion, with one exception: content-hashed frontend assets under `_static/` (`chunk-*-[hash].js`, `chunk-*-[hash].css`, `asset-*-[hash].*`, and the entry bundle once it is hashed) keep their 10 newest stale versions per asset. An asset changes at most once per build, so this keeps the assets of the last 10 builds reachable for pages that are still open in a browser or served from a cache. The kept keys are listed under `retain` in the plan.

## Options

<definitions>
  <definition term="--environment string required">
    Named deployment target.
  </definition>
  <definition term="--s3-bucket-name string required">
    S3 bucket to deploy to.
  </definition>
  <definition term="--out string">
    Path to write the plan file. Defaults to stdout.
    **Constraints:** symbolic links not allowed
  </definition>
  <definition term="--delete-threshold number">
    Abort if the plan would delete more than this percentage of objects (0–100).
  </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="--skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>


## Global Options

<definitions>
  <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="--skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>