---
title: assembler deploy plan cli command
description: Compute a diff of what would change when deploying to S3 and write it to a plan file. Two-step deployment: plan computes the diff and writes a plan file;...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2927/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]
```
> Authentication is required.> Scope: `global`.
Compute a diff of what would change when deploying to S3 and write it to a plan file.

## 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>


## Notes

Two-step deployment: plan computes the diff and writes a plan file; apply executes it.
Review the plan before applying to avoid accidental mass deletions.