AWS Elastic Beanstalk
Developer Guide

Getting Started with .NET on Elastic Beanstalk

To get started with .NET applications on AWS Elastic Beanstalk, all you need is an application source bundle to upload as your first application version and to 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 as well as more complex examples that show the use of additional AWS resources such as Amazon RDS and language or platform-specific features and APIs.



Supported Configurations

Environment Type



.NET Default

WS 2012 R2

WS 2012 R2 Server Core

WS 2012

WS 2008 R2

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.


For a Windows production environment, we recommend changing the default Amazon EC2 instance type to t2.medium or better. Be aware that the t2.medium instance type isn’t eligible for the AWS Free Tier.

To change the instance type, choose Configure more options during the procedure, and then choose Modify in the Instances configuration category.

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. From the Actions menu in the upper right corner, choose Create environment.

  4. Choose either the Web server environment or Worker environment environment tier. You cannot change an environment's tier after creation.


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

  5. Choose a Platform that matches the language used by your application.


    Elastic Beanstalk supports multiple versions 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, as described below.

  6. For App code, choose Sample application.

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

    • Environment name

    • Domain name

    • Platform version (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 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 very quick because it doesn't require provisioning or restarting EC2 instances.

After you've deployed a sample application or two and are ready to start developing locally, see the next section to set up a .NET development environment.