Getting started with .NET on Elastic Beanstalk - AWS Elastic Beanstalk

Getting started with .NET on Elastic Beanstalk

To get started with .NET applications on AWS Elastic Beanstalk, you only need an application source bundle to upload as your first application version and deploy to an environment. When you create an environment, Elastic Beanstalk allocates all of the AWS resources needed to run a highly scalable web application.

Launching an environment with a sample .NET application

Elastic Beanstalk provides single page sample applications for each platform and more complex examples that show the use of additional AWS resources. These include Amazon RDS and language or platform-specific features and APIs.



Supported configurations

Environment type



.NET Default

WS 2019 R2

WS 2019 R2 Server Core

WS 2016 R2

WS 2016 R2 Server Core

WS 2012 R2

WS 2012 R2 Server Core

WS 2012

Web Server

ASP.NET web application with a single page configured to be displayed at the website root.


WS 2012 R2

Web Server

ASP.NET web application with a classic model-view-control architecture.

Download any of the sample applications and deploy it to Elastic Beanstalk by using the following procedure.

To launch an environment with a sample application (console)

  1. Open the Elastic Beanstalk console, and in the Regions list, select your AWS Region.

  2. In the navigation pane, choose Applications, and then choose an existing application's name in the list or create one.

  3. On the application overview page, choose Create a new environment.

        The application overview page with a list of application environments on the Elastic Beanstalk console
  4. Next, for environment tier, choose the Web server environment or Worker environment environment tier. You can't change an environment's tier after creation.


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

        The Select environment tier page on the Elastic Beanstalk console
  5. For Platform, select the platform and platform branch that match the language your application uses.


    Elastic Beanstalk supports multiple versions for most of the platforms that are listed. By default, the console selects the recommended version for the platform and platform branch you choose. If your application requires a different version, you can select it here, or choose Configure more options, as described in step 7. For information about supported platform versions, see Elastic Beanstalk supported platforms.

  6. For Application code, choose Sample application.

  7. To further customize your environment, choose Configure more options. You can set the following options only during environment creation:

    • Environment name

    • Domain name

    • Platform version

    • Processor

    • VPC

    • Tier

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

    • Instance type, root volume, key pair, and AWS Identity and Access Management (IAM) role

    • Internal Amazon RDS database

    • Load balancer

    For details on all available settings, see The create new environment wizard.

  8. Choose Create environment.

Next steps

After you have an environment running an application, you can deploy a new version of the application or a completely different application at any time. Deploying a new application version is quick because it doesn't require provisioning or restarting EC2 instances.

After you've deployed a sample application or two and you're ready to start developing locally, you can follow the instructions in the next section to set up a .NET development environment.