AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)
AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

eb deploy


Deploys the application source bundle from the initialized project directory to the running application.

If git is installed, EB CLI uses the git archive command to create a .zip file from the contents of the most recent git commit command.


You can configure the EB CLI to deploy an artifact from your build process instead of creating a ZIP file of your project folder. See Deploying an Artifact Instead of the Project Folder for details.


eb deploy

eb deploy environment_name




-l version_label


--label version_label

The version label for the application version that EB CLI deploys. If the version label includes spaces, surround it in double quotes.

Type: String

--env-group-suffix groupname Group name to append to the environment name. Only for use with Compose Environments.

-m "version_description"


--message "version_description"

The description for the application version, enclosed in double quotation marks.

Type: String

--modules component-a component-b

List of components to update. Only for use with Compose Environments.




Preprocess and validate the environment manifest and configuration files in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment.

--source codecommit/repository-name/branch-name

AWS CodeCommit repository and branch. See Using the EB CLI with AWS CodeCommit.


Deploy files staged in the git index instead of the HEAD commit.

--timeout minutes

The number of minutes before the command times out.

--version version_label

An existing application version to deploy.

Type: String

Common options


If successful, the command returns the status of the deploy operation.

If you enabled AWS CodeBuild support in your application, eb deploy displays information from AWS CodeBuild as your code is built. Learn more about AWS CodeBuild support in Elastic Beanstalk in the Using the EB CLI with AWS CodeBuild topic.


The following example deploys the current application.

$ eb deploy INFO: Environment update is starting. INFO: Deploying new version to instance(s). INFO: New application version was deployed to running EC2 instances. INFO: Environment update completed successfully.