---
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. 
url: https://docs-v3-preview.elastic.dev/docs-builder/cli/assembler/deploy/plan
products:
  - Elastic Docs Builder
---

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

<cli-modifiers>
</cli-modifiers>

Creates an incremental synchronization plan by comparing the remote `--s3-bucket-name` with the local output of the build.

## 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, supports `~` home expansion
  </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="--[no-]skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>