Elastic Beanstalk supported platforms
AWS Elastic Beanstalk provides managed platforms that support running web applications developed for specific programming languages, frameworks, and web containers. Elastic Beanstalk offers one or more platform versions for each platform. When you create an environment and choose a platform, Elastic Beanstalk provisions the resources that your application needs, including one or more Amazon Elastic Compute Cloud (Amazon EC2) instances. The software stack running on the Amazon EC2 instances depends on the platform version you chose.
For more information about platforms, see AWS Elastic Beanstalk Platforms in the AWS Elastic Beanstalk Developer Guide. Detailed release notes are available for recent releases at AWS Elastic Beanstalk Release Notes.
The following sections provide information about all current platform versions. All current Linux-based platform versions run on Amazon Linux 2018.03 (64-bit). For lists of historical platform versions and the date ranges they were current, see Platform history.
Elastic Beanstalk has scheduled some platform versions for retirement, because some of their components are reaching their End of Life (EOL). These platform versions remain available until the published retirement date of their retiring components. For a list of component retirement dates, see AWS Elastic Beanstalk Platform Support Policy in the AWS Elastic Beanstalk Developer Guide. For a list of platform versions scheduled for retirement, see Elastic Beanstalk platform versions scheduled for retirement.
Topics
Docker
Docker is a container platform that allows you to define your own software stack and store it in an image that can be downloaded from a remote repository. Use the Docker platform if you only need to run a single Docker container on each instance in your environment. The Docker platform includes an nginx proxy server.
See Deploying Elastic Beanstalk Applications from Docker Containers in the AWS Elastic Beanstalk Developer Guide for more information about the Docker platform.
|
Platform Version and Solution Stack Name |
AMI |
Docker |
Docker Compose |
Proxy Server |
|---|---|---|---|---|
|
Docker AL2 version 3.4.1 64bit Amazon Linux 2 v3.4.1 running Docker |
2.0.20210525 |
20.10.4 |
1.29.2 |
nginx 1.20.0 |
|
Single Container Docker version 2.16.8 64bit Amazon Linux 2018.03 v2.16.8 running Docker 19.03.13-ce |
2018.03.0 |
19.03.13-ce |
nginx 1.18.0 |
For information about previous platform versions, see Docker platform history.
Multicontainer Docker
Docker is a container platform that allows you to define your own software stack and store it in an image that can be downloaded from a remote repository. Use the Multicontainer Docker platform if you need to run multiple containers on each instance. The Multicontainer Docker platform does not include a proxy server.
Elastic Beanstalk uses Amazon Elastic Container Service (Amazon ECS) to coordinate container deployments to multicontainer Docker environments. Some regions don't offer Amazon ECS. Multicontainer Docker isn't supported in these regions.
For information about the AWS services offered in each region, see
Region Table
See Deploying Elastic Beanstalk Applications from Docker Containers in the AWS Elastic Beanstalk Developer Guide for more information about the Docker platform.
|
Platform Version and Solution Stack Name |
AMI |
Docker |
ECS Agent |
|---|---|---|---|
|
Multicontainer Docker version 2.26.1 64bit Amazon Linux 2018.03 v2.26.1 running Multi-container Docker 19.03.13-ce (Generic) |
2018.03.0 |
19.03.13-ce |
1.51.0 |
For information about previous platform versions, see Multicontainer Docker platform history.
Preconfigured Docker
The Preconfigured Docker platform uses Docker, but doesn't let you provide your own Docker images. The preconfigured containers provide application frameworks that are not available on other platforms, such as Glassfish. They also provide support for Go applications prior to the release of the full-fledged Go platform.
|
Platform Version and Solution Stack Name |
AMI |
Platform |
Container OS |
Language |
Proxy Server |
Application Server |
Docker Image |
|---|---|---|---|---|---|---|---|
|
Glassfish 5.0 (Docker) version 2.16.8 64bit Amazon Linux v2.16.8 running GlassFish 5.0 Java 8 (Preconfigured - Docker) |
2018.03.0 |
Docker 19.03.13-ce |
Amazon Linux 2018.03 |
Java 8 |
nginx 1.18.0 |
Glassfish 5.0 |
amazon/aws-eb-glassfish:5.0-al-onbuild-2.11.1 |
For information about previous platform versions, see Preconfigured Docker platform history.
Go
Elastic Beanstalk supports the following Go platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Language |
AWS X-Ray |
Proxy Server |
|---|---|---|---|---|
|
Go 1 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running Go 1 |
2.0.20210525 |
Go 1.16.5 |
3.2.0 |
nginx 1.20.0 |
|
Go 1 version 2.18.3 64bit Amazon Linux 2018.03 v2.18.3 running Go 1.16.4 |
2018.03.0 |
Go 1.16.4 |
3.1.0 |
nginx 1.18.0 |
For information about previous platform versions, see Go platform history.
Java SE
Elastic Beanstalk supports the following Java SE platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Language |
Tools |
AWS X-Ray |
Proxy Server |
|---|---|---|---|---|---|
|
Corretto 11 version 3.2.1 64bit Amazon Linux 2 v3.2.1 running Corretto 11 |
2.0.20210525 |
Corretto 11.0.11.9.1 |
Ant 1.10.7, Gradle 5.6.2, Maven 3.6.2 |
3.2.0 |
nginx 1.20.0 |
|
Corretto 8 version 3.2.1 64bit Amazon Linux 2 v3.2.1 running Corretto 8 |
2.0.20210525 |
Corretto 8.292.10.1 |
Ant 1.10.7, Gradle 5.6.2, Maven 3.6.2 |
3.2.0 |
nginx 1.20.0 |
|
Java 8 version 2.11.8 64bit Amazon Linux 2018.03 v2.11.8 running Java 8 |
2018.03.0 |
Java 1.8.0_282 |
Ant 1.9.6, Gradle 2.7, Maven 3.3.3 |
3.1.0 |
nginx 1.18.0 |
|
Java 7 version 2.11.8 64bit Amazon Linux 2018.03 v2.11.8 running Java 7 |
2018.03.0 |
Java 1.7.0_261 |
Ant 1.9.6, Gradle 2.7, Maven 3.3.3 |
3.1.0 |
nginx 1.18.0 |
For information about previous platform versions, see Java SE platform history.
Tomcat
Elastic Beanstalk supports the following Tomcat platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Language |
AWS X-Ray |
Application Server |
Proxy Server |
|---|---|---|---|---|---|
|
Corretto 11 with Tomcat 8.5 AL2 version 4.2.1 64bit Amazon Linux 2 v4.2.1 running Tomcat 8.5 Corretto 11 |
2.0.20210525 |
Corretto 11.0.11.9.1 |
3.2.0 |
Tomcat 8.5.63 |
nginx 1.20.0 (default), Apache 2.4.46 |
|
Corretto 8 with Tomcat 8.5 AL2 version 4.2.1 64bit Amazon Linux 2 v4.2.1 running Tomcat 8.5 Corretto 8 |
2.0.20210525 |
Corretto 8.292.10.1 |
3.2.0 |
Tomcat 8.5.63 |
nginx 1.20.0 (default), Apache 2.4.46 |
|
Java 8 with Tomcat 8.5 version 3.4.7 64bit Amazon Linux 2018.03 v3.4.7 running Tomcat 8.5 Java 8 |
2018.03.0 |
Java 1.8.0_282 |
3.1.0 |
Tomcat 8.5.63 |
Apache 2.4.46 (default), Nginx 1.18.0 |
For information about platform versions scheduled for retirement as published in Platform Support Policy, see Tomcat on the Retiring Platform Versions page. For information about previous platform versions, see Tomcat platform history.
.NET Core on Linux
Elastic Beanstalk supports the following .NET Core on Linux platform versions.
|
Platform Version and Solution Stack Name |
Framework |
Proxy Server |
AMI |
AWS X-Ray |
|---|---|---|---|---|
|
.NET Core on AL2 version 2.2.1 64bit Amazon Linux 2 v2.2.1 running .NET Core |
.NET 5.0.6, supports 5.0.6, 3.1.15, 2.1.28 |
nginx 1.20.0 |
2.0.20210525 |
3.2.0 |
For information about previous platform versions, see .NET Core on Linux platform history.
.NET on Windows Server
You can get started in minutes using the AWS Toolkit for Visual Studio
This platform doesn't support the following Elastic Beanstalk features:
-
Worker environments. For details, see AWS Elastic Beanstalk Worker Environments in the AWS Elastic Beanstalk Developer Guide.
-
Bundle logs. For details, see Viewing Logs from Amazon EC2 Instances in Your Elastic Beanstalk Environment in the AWS Elastic Beanstalk Developer Guide.
In addition, platform versions earlier than v2.0.0 don't support enhanced health reporting, managed platform updates, immutable updates, immutable deployments, and rolling deployments with an additional batch.
To learn how to get started deploying a .NET application using the AWS Toolkit for Visual Studio, see Creating and Deploying Elastic Beanstalk Applications in .NET Using AWS Toolkit for Visual Studio in the AWS Elastic Beanstalk Developer Guide.
For information about the latest Microsoft security updates, see
Security TechCenter
For information about .NET on Windows Server platform versions scheduled for retirement as published in Platform Support Policy, see .NET on Windows Server on the Retiring Platform Versions page. For information about previous .NET on Windows Server platform versions for Elastic Beanstalk, see .NET on Windows Server platform history.
Elastic Beanstalk supports the following .NET on Windows Server platform versions.
Configuration basics
|
Platform Version |
Solution Stack Name |
Framework |
Proxy Server |
|---|---|---|---|
|
Windows Server 2019 with IIS 10.0 version 2.6.6 |
64bit Windows Server 2019 v2.6.6 running IIS 10.0 |
.NET 5.0.6, supports 5.0.6, 3.1.15, 2.2.8, 2.1.28 .NET Framework 4.8, supports 4.x, 2.0, 1.x |
IIS 10.0 |
|
Windows Server Core 2019 with IIS 10.0 version 2.6.6 |
64bit Windows Server Core 2019 v2.6.6 running IIS 10.0 |
.NET 5.0.6, supports 5.0.6, 3.1.15, 2.2.8, 2.1.28 .NET Framework 4.8, supports 4.x, 2.0, 1.x |
IIS 10.0 |
|
Windows Server 2016 with IIS 10.0 version 2.6.6 |
64bit Windows Server 2016 v2.6.6 running IIS 10.0 |
.NET 5.0.6, supports 5.0.6, 3.1.15, 2.2.8, 2.1.28 .NET Framework 4.8, supports 4.x, 2.0, 1.x |
IIS 10.0 |
|
Windows Server Core 2016 with IIS 10.0 version 2.6.6 |
64bit Windows Server Core 2016 v2.6.6 running IIS 10.0 |
.NET 5.0.6, supports 5.0.6, 3.1.15, 2.2.8, 2.1.28 .NET Framework 4.8, supports 4.x, 2.0, 1.x |
IIS 10.0 |
|
Windows Server 2012 R2 with IIS 8.5 version 2.6.6 |
64bit Windows Server 2012 R2 v2.6.6 running IIS 8.5 |
.NET Core 3.0.0, supports 3.0.0, 2.2.8, 2.1.28 .NET Framework 4.8, supports 4.x, 2.0, 1.x |
IIS 8.5 |
|
Windows Server 2012 R2 Server Core with IIS 8.5 version 2.6.6 |
64bit Windows Server Core 2012 R2 v2.6.6 running IIS 8.5 |
.NET Core 3.0.0, supports 3.0.0, 2.2.8, 2.1.28 .NET Framework 4.8, supports 4.x, 2.0, 1.x |
IIS 8.5 |
More details
|
Platform Version |
AMI version |
AWS SDK for .NET |
EC2Config |
SSM Agent |
Web Deploy |
AWS X-Ray |
|---|---|---|---|---|---|---|
|
Windows Server 2019 with IIS 10.0 version 2.6.6 |
2021.05.11 |
3.15.1302 |
3.0.529.0 |
3.6 |
3.2.0 |
|
|
Windows Server Core 2019 with IIS 10.0 version 2.6.6 |
2021.05.11 |
3.15.1302 |
3.0.529.0 |
3.6 |
3.2.0 |
|
|
Windows Server 2016 with IIS 10.0 version 2.6.6 |
2021.05.11 |
3.15.1302 |
3.0.529.0 |
3.6 |
3.2.0 |
|
|
Windows Server Core 2016 with IIS 10.0 version 2.6.6 |
2021.05.11 |
3.15.1302 |
3.0.529.0 |
3.6 |
3.2.0 |
|
|
Windows Server 2012 R2 with IIS 8.5 version 2.6.6 |
2021.05.11 |
3.15.1302 |
4.9.4381 |
3.0.529.0 |
3.6 |
3.2.0 |
|
Windows Server 2012 R2 Server Core with IIS 8.5 version 2.6.6 |
2021.05.11 |
3.15.1302 |
4.9.4381 |
3.0.529.0 |
3.6 |
3.2.0 |
Node.js
Each Node.js platform version supports a few Node.js language versions. Valid Node.js versions, as well as the default version, are listed in the following table. Each Node.js version includes a respective version of npm (the Node.js package manager). The table lists npm versions in parentheses.
On Amazon Linux 2 platform versions, only the default Node.js version is pre-installed.
You can use a package.json file in the root of your project source
to specify the Node.js version you want your application to use.
For details, see Configuring Node.js with a package.json file
in the AWS Elastic Beanstalk Developer Guide.
On Amazon Linux AMI platform versions (preceding Amazon Linux 2), all listed Node.js
versions that a platform version supports are pre-installed on it.
The default Node.js version applies when the NodeVersion option in the aws:elasticbeanstalk:container:nodejs namespace isn't set.
For details, see Node.js Platform Options
in the AWS Elastic Beanstalk Developer Guide.
Node.js versions 4.x to 8.x have an upcoming retirement date. We recommend that you avoid using them in new applications, and migrate existing applications to the latest version.
Elastic Beanstalk supports the following Node.js platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Node.js versions (npm versions) |
Proxy Server |
Git |
AWS X-Ray |
|---|---|---|---|---|---|
|
Node.js 14 AL2 version 5.4.1 64bit Amazon Linux 2 v5.4.1 running Node.js 14 |
2.0.20210525 |
14.17.0 (6.14.13), 14.16.1 (6.14.12), 14.16.0 (6.14.11), 14.15.5 (6.14.11), 14.15.4 (6.14.10), 14.15.3 (6.14.9), 14.15.2 (6.14.9), 14.15.1 (6.14.8), 14.15.0 (6.14.8), 14.14.0 (6.14.8), 14.13.1 (6.14.8), 14.13.0 (6.14.8), 14.12.0 (6.14.8), 14.11.0 (6.14.8), 14.10.1 (6.14.8), 14.10.0 (6.14.8), 14.9.0 (6.14.8), 14.8.0 (6.14.7), 14.7.0 (6.14.7), 14.6.0 (6.14.6), 14.5.0 (6.14.5), 14.4.0 (6.14.5), 14.3.0 (6.14.5), 14.2.0 (6.14.4), 14.1.0 (6.14.4), 14.0.0 (6.14.4) Default version: 14.17.0 |
nginx 1.20.0 (default), Apache 2.4.46 |
2.23.4 |
3.2.0 |
|
Node.js 12 AL2 version 5.4.1 64bit Amazon Linux 2 v5.4.1 running Node.js 12 |
2.0.20210525 |
12.22.1 (6.14.12), 12.22.0 (6.14.11), 12.21.0 (6.14.11), 12.20.2 (6.14.11), 12.20.1 (6.14.10), 12.20.0 (6.14.8), 12.19.1 (6.14.8), 12.19.0 (6.14.8), 12.18.4 (6.14.6), 12.18.3 (6.14.6), 12.18.2 (6.14.5), 12.18.1 (6.14.5), 12.18.0 (6.14.4), 12.17.0 (6.14.4), 12.16.3 (6.14.4), 12.16.2 (6.14.4), 12.16.1 (6.13.4), 12.16.0 (6.13.4), 12.15.0 (6.13.4), 12.14.1 (6.13.4), 12.14.0 (6.13.4), 12.13.1 (6.12.1), 12.13.0 (6.12.0), 12.12.0 (6.11.3), 12.11.1 (6.11.3), 12.11.0 (6.11.3), 12.10.0 (6.10.3), 12.9.1 (6.10.2), 12.9.0 (6.10.2), 12.8.1 (6.10.2), 12.8.0 (6.10.2), 12.7.0 (6.10.0), 12.6.0 (6.9.0), 12.5.0 (6.9.0), 12.4.0 (6.9.0), 12.3.1 (6.9.0), 12.3.0 (6.9.0), 12.2.0 (6.9.0), 12.1.0 (6.9.0), 12.0.0 (6.9.0) Default version: 12.22.1 |
nginx 1.20.0 (default), Apache 2.4.46 |
2.23.4 |
3.2.0 |
|
Node.js version 4.17.6 64bit Amazon Linux 2018.03 v4.17.6 running Node.js |
2018.03.0 |
12.22.1 (6.14.12), 12.22.0 (6.14.11), 12.21.0 (6.14.11), 12.20.2 (6.14.11), 12.20.1 (6.14.10), 12.20.0 (6.14.8), 12.19.1 (6.14.8), 12.19.0 (6.14.8), 12.18.4 (6.14.6),12.18.3 (6.14.6), 12.18.2 (6.14.5), 12.18.1 (6.14.5), 12.18.0 (6.14.4), 12.16.4 (6.14.4), 12.16.2 (6.14.4), 12.16.1 (6.13.4), 12.15.0 (6.13.4), 12.14.1 (6.13.4), 12.14.0 (6.13.4), 10.24.1 (6.14.12), 10.24.0 (6.14.11), 10.23.3 (6.14.11), 10.23.2 (6.14.10), 10.23.1 (6.14.10), 10.23.0 (6.14.8), 10.22.1 (6.14.6), 10.22.0 (6.14.6), 10.21.0 (6.14.4), 10.20.1 (6.14.4), 10.20.0(6.14.4), 10.19.0 (6.13.4), 10.18.1 (6.13.4), 10.18.0 (6.13.4), 10.17.0 (6.11.3), 10.16.3 (6.9.0), 10.16.2 (6.9.0), 10.16.1 (6.9.0), 10.16.0 (6.9.0), 10.15.3 (6.4.1), 10.15.1 (6.4.1), 10.15.0 (6.4.1), 10.14.1 (6.4.1) Default version: 12.22.1 |
nginx 1.18.0, Apache 2.4.43 |
2.18.5 |
3.1.0 |
For information about platform versions scheduled for retirement as published in Platform Support Policy, see Node.js on the Retiring Platform Versions page. For information about previous platform versions, see Node.js platform history.
When support for the version of Node.js that you are using is removed from the platform version, you must change or remove the version setting prior to doing a platform update. This may occur when a security vulnerability is identified for the Node.js version, or when the version is retired.
When this happens, attempting to update to a new version of the platform that doesn't support the configured Node.js version fails. To avoid needing to create a new environment:
-
Amazon Linux 2 – change the Node.js version setting in
package.jsonto a Node.js version that is supported by both the old platform version and the new one, or remove the setting, and then deploy the new source bundle. Only then perform the platform update. -
Amazon Linux AMI – change the
NodeVersionconfiguration option to a version that is supported by both the old platform version and the new one, or remove the option setting, and then perform the platform update.
PHP
Some PECL packages for PHP 7.3 aren't available in the Amazon Linux 1 repository and some PECL packages for PHP 7.4 aren't available in the Amazon Linux 2 repository. Therefore, they aren't included in our platform. If your application depends on them, you'll need to add commands to install them.
Elastic Beanstalk supports the following PHP platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Language |
Composer |
Proxy Server |
|---|---|---|---|---|
|
PHP 8.0 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running PHP 8.0 |
2.0.20210525 |
PHP 8.0.6 |
2.0.13 |
nginx 1.20.0 (default), Apache 2.4.46 |
|
PHP 7.4 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running PHP 7.4 |
2.0.20210525 |
PHP 7.4.19 |
1.10.22 |
nginx 1.20.0 (default), Apache 2.4.46 |
For information about platform versions scheduled for retirement as published in Platform Support Policy, see PHP on the Retiring Platform Versions page. For information about previous platform versions, see PHP platform history.
Python
The pip version on Python platform versions based on Amazon Linux 2 isn't locked - the platform always uses the latest version. We only list pipenv versions for these platform versions.
Elastic Beanstalk supports the following Python platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Language |
Package Manager |
Packager |
meld3 |
AWS X-Ray |
Proxy Server |
|---|---|---|---|---|---|---|---|
|
Python 3.8 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running Python 3.8 |
2.0.20210525 |
Python 3.8.5 |
pipenv 2020.8.13 |
3.2.0 |
nginx 1.20.0 (default), Apache 2.4.46 |
||
|
Python 3.7 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running Python 3.7 |
2.0.20210525 |
Python 3.7.9 |
pipenv 2020.8.13 |
3.2.0 |
nginx 1.20.0 (default), Apache 2.4.46 |
||
|
Python 3.6 version 2.10.1 64bit Amazon Linux 2018.03 v2.10.1 running Python 3.6 |
2018.03.0 |
Python 3.6.12 |
pip 9.0.3 |
setuptools 56.0.0 |
meld3 1.0.2 |
3.1.0 |
Apache 2.4.46 with mod_wsgi 3.5 |
For information about previous platform versions, see Python platform history.
Ruby
Elastic Beanstalk supports the following Ruby platform versions.
|
Platform Version and Solution Stack Name |
AMI |
Language |
Package Manager |
Application Server |
AWS X-Ray |
Proxy Server |
|---|---|---|---|---|---|---|
|
Ruby 2.7 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running Ruby 2.7 |
2.0.20210525 |
Ruby 2.7.3-p183 |
RubyGems 3.2.17 |
Puma 5.3.2 |
3.2.0 |
nginx 1.20.0 |
|
Ruby 2.6 AL2 version 3.3.1 64bit Amazon Linux 2 v3.3.1 running Ruby 2.6 |
2.0.20210525 |
Ruby 2.6.7-p197 |
RubyGems 3.2.17 |
Puma 5.3.2 |
3.2.0 |
nginx 1.20.0 |
|
Ruby 2.6 with Puma version 2.12.7 64bit Amazon Linux 2018.03 v2.12.7 running Ruby 2.6 (Puma) |
2018.03.0 |
Ruby 2.6.7-p197 |
RubyGems 3.2.15 |
Puma 2.16.0 |
3.1.0 |
nginx 1.18.0 |
|
Ruby 2.6 with Passenger version 2.12.7 64bit Amazon Linux 2018.03 v2.12.7 running Ruby 2.6 (Passenger Standalone) |
2018.03.0 |
Ruby 2.6.7-p197 |
RubyGems 3.2.15 |
Passenger 4.0.60 |
3.1.0 |
nginx 1.18.0 |
For information about platform versions scheduled for retirement as published in Platform Support Policy, see Ruby on the Retiring Platform Versions page. For information about previous platform versions, see Ruby platform history.
