AWS Elastic Beanstalk
Developer Guide

Constructing a Launch Now URL

You can construct a custom uniform resource locator (URL) so that anyone can quickly deploy and run a predetermined web application in AWS Elastic Beanstalk. This URL is called a Launch Now URL. You might need a Launch Now URL, for example, to demonstrate a web application that is built to run on Elastic Beanstalk. With a Launch Now URL, you can use parameters to add the required information to the Create Application wizard in advance. When you do, anyone can use the URL link to launch an Elastic Beanstalk environment with your web application source in just a few steps. This means users don't need to manually upload or specify the location of the application source bundle or provide any additional input to the wizard.

A Launch Now URL gives Elastic Beanstalk the minimum information required to create an application: the application name, solution stack, instance type, and environment type. Elastic Beanstalk uses default values for other configuration details that are not explicitly specified in your custom Launch Now URL.

A Launch Now URL uses standard URL syntax. For more information, see RFC 3986 - Uniform Resource Identifier (URI): Generic Syntax.

URL Parameters

The URL must contain the following parameters, which are case-sensitive:

  • region – Specify an AWS Region. For a list of regions supported by Elastic Beanstalk, see AWS Elastic Beanstalk in the Amazon Web Services General Reference.

  • applicationName – Specify the name of your application. Elastic Beanstalk displays the application name in the AWS Management Console to distinguish it from other applications. By default, the application name also forms the basis of the environment name and environment URL.

  • platform – Specify the platform configuration to use for the environment. Use one of the following methods, then URL-encode your choice:

    • Specify the configuration's ARN without a version. Elastic Beanstalk selects the configuration's latest version. For example:

      Python 3.6 running on 64bit Amazon Linux

    • Specify the platform name. Elastic Beanstalk selects the latest version of the platform's latest language configuration. For example:


    For a description of all available platforms and their configurations, see Elastic Beanstalk Supported Platforms.

    You can use the AWS Command Line Interface (AWS CLI) to get a list of available configurations with their respective ARNs. The list-platform-versions command lists detailed information about all available configurations. The --filters argument allows you to scope down the list. For example, you can list all configurations of a specific language.

    The following example queries for all Python configurations, and pipes the output through a series of commands. The result is the platform configuration name of each ARN, in human-readable format, without URL encoding.

    $ aws elasticbeanstalk list-platform-versions --filters 'Type="PlatformName",Operator="contains",Values="Python"' | grep PlatformArn | awk -F '"' '{print $4}' | awk -F '/' '{print $2}' Preconfigured Docker - Python 3.4 running on 64bit Debian Preconfigured Docker - Python 3.4 running on 64bit Debian Python 2.6 running on 32bit Amazon Linux Python 2.6 running on 32bit Amazon Linux 2014.03 ... Python 3.6 running on 64bit Amazon Linux

    The following example adds a Perl command to the last example, to URL-encode the output.

    $ aws elasticbeanstalk list-platform-versions --filters 'Type="PlatformName",Operator="contains",Values="Python"' | grep PlatformArn | awk -F '"' '{print $4}' | awk -F '/' '{print $2}' | perl -MURI::Escape -ne 'chomp;print uri_escape($_),"\n"' Preconfigured%20Docker%20-%20Python%203.4%20running%20on%2064bit%20Debian Preconfigured%20Docker%20-%20Python%203.4%20running%20on%2064bit%20Debian Python%202.6%20running%20on%2032bit%20Amazon%20Linux Python%202.6%20running%20on%2032bit%20Amazon%20Linux%202014.03 ... Python%203.6%20running%20on%2064bit%20Amazon%20Linux

A Launch Now URL can optionally contain the following parameters. If you don't include the optional parameters in your Launch Now URL, Elastic Beanstalk uses default values to create and run your application. When you don't include the sourceBundleUrl parameter, Elastic Beanstalk uses the default sample application for the specified platform.

  • sourceBundleUrl – Specify the location of your web application source bundle in URL format. For example, if you uploaded your source bundle to an Amazon S3 bucket, you might specify the value of the sourceBundleUrl parameter as


    You can specify the value of the sourceBundleUrl parameter as an HTTP URL, but the user's web browser will convert characters as needed by applying HTML URL encoding.

  • environmentType – Specify whether the environment is load balancing and automatically scaling or just a single instance. For more information, see Environment Types. You can specify either LoadBalancing or SingleInstance as the parameter value.

  • tierName – Specify whether the environment supports a web application that processes web requests or a web application that runs background jobs. For more information, see AWS Elastic Beanstalk Worker Environments. You can specify either WebServer or Worker,

  • instanceType – Specify a server with the characteristics (including memory size and CPU power) that are most appropriate to your application. To see the instance types that are available in your Elastic Beanstalk region, see InstanceType in Configuration Options. To see the detailed specifications for each Amazon EC2 instance type, see Instance Types.

  • withVpc – Specify whether to create the environment in an Amazon VPC. You can specify either true or false. For more information about using Elastic Beanstalk with Amazon VPC, see Using Elastic Beanstalk with Amazon Virtual Private Cloud.

  • withRds – Specify whether to create an Amazon RDS database instance with this environment. For more information, see Using Elastic Beanstalk with Amazon Relational Database Service. You can specify either true or false.

  • rdsDBEngine – Specify the database engine that you want to use for your Amazon EC2 instances in this environment. You can specify mysql, oracle-sel, sqlserver-ex, sqlserver-web, or sqlserver-se. The default value is mysql.

  • rdsDBAllocatedStorage – Specify the allocated database storage size in gigabytes. You can specify the following values:

    • MySQL5 to 1024. The default is 5.

    • Oracle10 to 1024. The default is 10.

    • Microsoft SQL Server Express Edition30.

    • Microsoft SQL Server Web Edition30.

    • Microsoft SQL Server Standard Edition200.

  • rdsDBInstanceClass – Specify the database instance type. The default value is db.t2.micro (db.m1.large for an environment not running in an Amazon VPC). For a list of database instance classes supported by Amazon RDS, see DB Instance Class in the Amazon Relational Database Service User Guide.

  • rdsMultiAZDatabase – Specify whether Elastic Beanstalk needs to create the database instance across multiple Availability Zones. You can specify either true or false. For more information about multiple Availability Zone deployments with Amazon RDS, go to Regions and Availability Zones in the Amazon Relational Database Service User Guide.

  • rdsDBDeletionPolicy – Specify whether to delete or snapshot the database instance on environment termination. You can specify either Delete or Snapshot.


The following is an example Launch Now URL. After you construct your own, you can give it to your users. For example, you might want to embed the URL on a webpage or in training materials. When users create an application using the Launch Now URL, the Elastic Beanstalk Create an Application wizard requires no additional input.

When users choose a Launch Now URL, Elastic Beanstalk displays a page similar to the following.

        Elastic Beanstalk mamagement console page for a Launch Now URL

To use the Launch Now URL

  1. Choose the Launch Now URL.

  2. When the Elastic Beanstalk console opens, on the Create a web app page, choose Review and launch to view the settings Elastic Beanstalk will use to create the application and launch the environment in which the application runs.

  3. On the Configure page, choose Create app to create the application.

On this page: