[ AWS CLI Command Reference ](../../index.html)

  * [ Home ](../../index.html)
  * [ User Guide ](https://docs.aws.amazon.com/cli/latest/userguide/)
  * [ Forum ](https://forums.aws.amazon.com/forum.jspa?forumID=150)
  * [ GitHub ](https://github.com/aws/aws-cli)

###  Navigation

  * [ index ](../../genindex.html "General Index")
  * [ next ](deregister-type.html "deregister-type") | 
  * [ previous ](delete-stack-set.html "delete-stack-set") | 
  * [ AWS CLI 2.15.40 Command Reference ](../../index.html) » 
  * [ aws ](../index.html) » 
  * [ cloudformation ](index.html) » 

  * [ ← delete-stack-set ](delete-stack-set.html "previous chapter \(use the left arrow\)") / 
  * [ deregister-type → ](deregister-type.html "next chapter \(use the right arrow\)")

[ ![Amazon Web Services logo](../../_static/logo.png) ](../../index.html)

###  [ Table of Contents ](../../index.html)

  * deploy 
    * Description 
    * Synopsis 
    * Options 
    * Global Options 
    * Examples 
      * Supported JSON syntax 

###  Quick search

Search box  Search

###  Feedback

Did you find this page useful? Do you have a suggestion to improve the
documentation? [ Give us feedback ](https://docs.aws.amazon.com/forms/aws-doc-
feedback?hidden_service_name=AWS%20Command%20Line%20Interface&hidden_guide_name=Reference&topic_url=https%3A%2F%2Fdocs.aws.amazon.com%2Fcli%2Flatest%2Freference/cloudformation/deploy.html)
.  
If you would like to suggest an improvement or fix for the AWS CLI, check out
our [ contributing guide ](https://github.com/aws/aws-
cli/blob/develop/CONTRIBUTING.md) on GitHub.

###  User Guide

First time using the AWS CLI? See the [ User Guide
](https://docs.aws.amazon.com/cli/latest/userguide/) for help getting started.

[ [ aws  ](../index.html#cli-aws) . [ cloudformation  ](index.html#cli-aws-
cloudformation) ]

#  deploy  Â¶

##  Description  Â¶

Deploys the specified AWS CloudFormation template by creating and then
executing a change set. The command terminates after AWS CloudFormation
executes the change set. If you want to view the change set before AWS
CloudFormation executes it, use the ` --no-execute-changeset  ` flag.

To update a stack, specify the name of an existing stack. To create a new
stack, specify a new stack name.

##  Synopsis  Â¶

    
    
      deploy
    --template-file <value>
    --stack-name <value>
    [--s3-bucket <value>]
    [--force-upload]
    [--s3-prefix <value>]
    [--kms-key-id <value>]
    [--parameter-overrides <value> [<value>...]]
    [--capabilities <value> [<value>...]]
    [--no-execute-changeset]
    [--disable-rollback | --no-disable-rollback]
    [--role-arn <value>]
    [--notification-arns <value> [<value>...]]
    [--fail-on-empty-changeset | --no-fail-on-empty-changeset]
    [--tags <value> [<value>...]]
    [--debug]
    [--endpoint-url <value>]
    [--no-verify-ssl]
    [--no-paginate]
    [--output <value>]
    [--query <value>]
    [--profile <value>]
    [--region <value>]
    [--version <value>]
    [--color <value>]
    [--no-sign-request]
    [--ca-bundle <value>]
    [--cli-read-timeout <value>]
    [--cli-connect-timeout <value>]
    [--cli-binary-format <value>]
    [--no-cli-pager]
    [--cli-auto-prompt]
    [--no-cli-auto-prompt]
    

##  Options  Â¶

` --template-file  ` (string) The path where your AWS CloudFormation template
is located.

` --stack-name  ` (string) The name of the AWS CloudFormation stack youâre
deploying to. If you specify an existing stack, the command updates the stack.
If you specify a new stack, the command creates it.

` --s3-bucket  ` (string) The name of the S3 bucket where this command uploads
your CloudFormation template. This is required the deployments of templates
sized greater than 51,200 bytes

` --force-upload  ` (boolean) Indicates whether to override existing files in
the S3 bucket. Specify this flag to upload artifacts even if they match
existing artifacts in the S3 bucket.

` --s3-prefix  ` (string) A prefix name that the comm