AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon AWS.

Creating an AWS Elastic Beanstalk Environment

You can deploy multiple environments when you need to run multiple versions of an application. For example, you might have development, integration, and production environments.


For instructions on creating and managing environments with the EB CLI, see Managing Elastic Beanstalk Environments with the EB CLI.

The Create New Environment wizard in the AWS Management Console guides you through the creation of an environment step by step, with a bevy of options for configuring the resources that Elastic Beanstalk deploys on your behalf. If you are just getting started, you can use the default values for many of these options without issue.


Creating an environment requires the permissions in the Elastic Beanstalk full access managed policy. See Elastic Beanstalk User Policy for details.

Follow this procedure to launch a new environment running the default application. These steps are simplified to get your environment up and running quickly. See The Create New Environment Wizard for more detailed instructions with descriptions of all of the available options.

To launch an environment with a sample application (console)

  1. Open the Elastic Beanstalk console.

  2. Choose an application or create a new one.

  3. In the upper right corner, choose Create New Environment from the Actions menu.

  4. Choose between Web server and Worker environment tiers. You cannot change an environment's tier after creation.


    The .NET on Windows Server platform doesn't support the worker environment tier.

  5. For Platform, choose the platform that matches the language used by your application.


    Elastic Beanstalk supports multiple configurations for most platforms listed. By default, the console selects the latest version of the language, web container or framework supported by Elastic Beanstalk. If your application requires an older version, choose Configure more options below.

  6. For App code, choose Sample application.

  7. If you would like to further customize your environment, choose Configure more options. The following options can only be set during environment creation:

    • Environment name

    • Domain name

    • Platform configuration

    • VPC

    • Tier

    The following settings can be changed after environment creation, but require new instances or other resources to be provisioned and can take a long time to apply:

    • Instance type, root volume, key pair, and IAM role

    • Internal RDS database

    • Load balancer

    For details on all available settings, see The Create New Environment Wizard.

  8. Choose Create environment.

While Elastic Beanstalk creates your environment, you are redirected to the The AWS Elastic Beanstalk Environment Management Console. Once the environment health turns green, click on the URL next to the environment name to view the running application. This URL is generally accessible from the Internet unless you configure your environment to use a custom VPC with an internal load balancer.