Elastic Beanstalk Linux platforms - Amazon Elastic Beanstalk
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Elastic Beanstalk Linux platforms

Most of the platforms that Elastic Beanstalk supports are based on the Linux operating system. Specifically, these platforms are based on Amazon Linux, a Linux distribution provided by Amazon. Elastic Beanstalk Linux platforms use Amazon Elastic Compute Cloud (Amazon EC2) instances, and these instances run Amazon Linux.

The Elastic Beanstalk Linux platforms provide a lot of functionality out of the box. You can extend the platforms in several ways to support your application. For details, see Extending Elastic Beanstalk Linux platforms.

Supported Amazon Linux versions

Amazon Elastic Beanstalk supports platforms based on Amazon Linux 2 and Amazon Linux 2023.

As of October 19, 2023, Elastic Beanstalk offers AL2023 platforms for all of the programming languages that are also supported on the Amazon Linux 2 platforms. Beanstalk also supports the Docker and ECS-based Docker platforms on both Amazon Linux 2 and Amazon Linux 2023.

For more information about Amazon Linux 2 and Amazon Linux 2023, see the following:

For details about supported platform versions, see Elastic Beanstalk supported platforms.

Note

You can migrate your application from an Elastic Beanstalk AL1 or AL2 platform branch to the equivalent AL2023 platform branch. For more information, see Migrating your Elastic Beanstalk Linux application to Amazon Linux 2023 or Amazon Linux 2.

Amazon Linux 2023

Amazon announced the general availability of Amazon Linux 2023 in March of 2023. The Amazon Linux 2023 User Guide summarizes key differences between Amazon Linux 2 and Amazon Linux 2023. For more information, see Comparing Amazon Linux 2 and Amazon Linux 2023 in the user guide.

There is a high degree of compatibility between Elastic Beanstalk Amazon Linux 2 and Amazon Linux 2023 platforms. Although there are some differences to note:

  • Instance Metadata Service Version 1 (IMDSv1) – The DisableIMDSv1 option setting defaults to true on AL2023 platforms. The default is false on AL2 platforms.

  • pkg-repo instance tool – The pkg-repo tool is not available for environments running on AL2023 platforms. However,you can manually apply package and operating system updates to an AL2023 instance. For more information, see Managing packages and operating system updates in the Amazon Linux 2023 User Guide.

  • Apache HTTPd configuration – The Apache httpd.conf file for AL2023 platforms has some configuration settings that are different from those for AL2:

    • Deny access to the server’s entire file system by default. These settings are described in Protect Server Files by Default on the Apache website Security Tips page.

    • Stop users from overriding security features you've configured. The configuration denies access to set up of .htaccess in all directories, except for those specifically enabled. This setting is described in Protecting System Settings on the Apache website Security Tips page. The Apache HTTP Server Tutorial: .htaccess files page states this setting may help improve performance.

    • Deny access to files with name pattern .ht*. This setting prevents web clients from viewing .htaccess and .htpasswd files.

You can change any of the above configuration settings for your environment. For more information, see Extending Elastic Beanstalk Linux platforms. Expand the Reverse Proxy topic to see the Configuring Apache HTTPD section.

List of Elastic Beanstalk Linux platforms

The following list provides the Linux platforms that Elastic Beanstalk supports for different programming languages as well as for Docker containers. Elastic Beanstalk offers platforms based on Amazon Linux 2 and Amazon Linux 2023 for all of them. To learn more about a platform, select the corresponding link.