Amazon Elastic Container Service
Developer Guide (API Version 2014-11-13)

Amazon ECS-optimized AMIs

The basic Amazon Elastic Container Service (Amazon ECS) container instance specification consists of the following:

Required

  • A modern Linux distribution running at least version 3.10 of the Linux kernel.

  • The Amazon ECS container agent (preferably the latest version). For more information, see Amazon ECS Container Agent.

  • A Docker daemon running at least version 1.9.0, and any Docker runtime dependencies. For more information, see Check runtime dependencies in the Docker documentation.

    Note

    For the best experience, we recommend the Docker version that ships with and is tested with the corresponding Amazon ECS agent version that you are using. For more information, see Amazon ECS Container Agent Versions.

Recommended

  • An initialization and nanny process to run and monitor the Amazon ECS agent. The Amazon ECS-optimized AMIs use the ecs-init RPM to manage the agent. For more information, see the ecs-init project on GitHub.

The Amazon ECS-optimized AMIs are preconfigured with these requirements and recommendations. We recommend that you use the Amazon ECS-optimized Amazon Linux 2 AMI for your container instances unless your application requires a specific operating system or a Docker version that is not yet available in that AMI.

Amazon ECS vends AMIs that are optimized for the service in the following variants.

  • Amazon ECS-optimized Amazon Linux 2 AMI – Recommended for launching your Amazon ECS container instances in most cases.

  • Amazon ECS-optimized Amazon Linux 2 (arm64) AMI – Recommended for launching your Amazon ECS container instances when using the Amazon EC2 A1 instance type, which is powered by Arm-based AWS Graviton Processors. For more information, see General Purpose Instances in the Amazon EC2 User Guide for Linux Instances.

  • Amazon ECS GPU-optimized AMI – Recommended for launching your Amazon ECS container instances when working with GPU workloads. For more information, see Working with GPUs on Amazon ECS.

  • Amazon ECS-optimized Amazon Linux AMI – This AMI is based off of Amazon Linux 1. We recommend that you migrate your workloads to the Amazon ECS-optimized Amazon Linux 2 AMI. Support for the Amazon ECS-optimized Amazon Linux AMI ends no later than June 30, 2020.

  • Amazon ECS-optimized Windows 2019 Full AMI – Recommended for launching your Amazon ECS container instances on the Windows operating system. For more information, see Windows Containers.

  • Amazon ECS-optimized Windows 2019 Core AMI – Recommended for launching your Amazon ECS container instances on the Windows operating system. For more information, see Windows Containers.

  • Amazon ECS-optimized Windows 1909 Core AMI – Available for launching your Amazon ECS container instances on the Windows operating system. For more information, see Windows Containers.

  • Amazon ECS-optimized Windows 2016 Full AMI – Available for launching your Amazon ECS container instances on the Windows operating system. For more information, see Windows Containers.

Although you can create your own container instance AMI that meets the basic specifications needed to run your containerized workloads on Amazon ECS, the Amazon ECS-optimized AMIs are preconfigured and tested on Amazon ECS by AWS engineers. It is the simplest way for you to get started and to get your containers running on AWS quickly.

The Amazon ECS-optimized AMI metadata, including the AMI name, Amazon ECS container agent version, and ECS runtime version which includes the Docker version, for each variant can be retrieved programmatically. For more information, see Retrieving Amazon ECS-Optimized AMI Metadata.

View the AMI IDs on one of the following tabs, according to the variant you choose.

Amazon Linux 2Amazon Linux 2 (arm64)Amazon Linux 2 (GPU)Amazon Linux AMIWindows Server 2019 FullWindows Server 2019 CoreWindows Server 1909 CoreWindows Server 2016 Full
Amazon Linux 2

The following table lists the current Amazon ECS-optimized Amazon Linux 2 AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID

Amazon Linux 2 (arm64)

The following table lists the current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

Amazon Linux 2 (GPU)

The current Amazon ECS GPU-optimized AMI consists of the following:

  • The recommended NVIDIA driver version (418.40.04)

  • The NVIDIA container runtime hook version (v1.4.0-1)

  • The recommended CUDA version (9.2.88)

The following table lists the current Amazon ECS GPU-optimized AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID

Amazon Linux AMI

The following table lists the current Amazon ECS-optimized Amazon Linux AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID

Windows Server 2019 Full

The following table lists the current Amazon ECS-optimized Windows 2019 Full AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID

Windows Server 2019 Core

The following table lists the current Amazon ECS-optimized Windows 2019 Core AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID

Windows Server 1909 Core

The following table lists the current Amazon ECS-optimized Windows 1909 Core AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID

Windows Server 2016 Full

The following table lists the current Amazon ECS-optimized Windows 2016 Full AMI IDs by Region.

Region Name

Region

AMI ID

US East (Ohio)

us-east-2

View AMI ID

US East (N. Virginia)

us-east-1

View AMI ID

US West (N. California)

us-west-1

View AMI ID

US West (Oregon)

us-west-2

View AMI ID

Asia Pacific (Hong Kong)

ap-east-1

View AMI ID

Asia Pacific (Tokyo)

ap-northeast-1

View AMI ID

Asia Pacific (Seoul)

ap-northeast-2

View AMI ID

Asia Pacific (Mumbai)

ap-south-1

View AMI ID

Asia Pacific (Singapore)

ap-southeast-1

View AMI ID

Asia Pacific (Sydney)

ap-southeast-2

View AMI ID

Canada (Central)

ca-central-1

View AMI ID

EU (Frankfurt)

eu-central-1

View AMI ID

EU (Stockholm)

eu-north-1

View AMI ID

EU (Ireland)

eu-west-1

View AMI ID

EU (London)

eu-west-2

View AMI ID

EU (Paris)

eu-west-3

View AMI ID

Middle East (Bahrain)

me-south-1

View AMI ID

South America (Sao Paulo)

sa-east-1

View AMI ID

AWS GovCloud (US-East)

us-gov-east-1

View AMI ID

AWS GovCloud (US-West)

us-gov-west-1

View AMI ID

China (Beijing)

cn-north-1

View AMI ID

China (Ningxia)

cn-northwest-1

View AMI ID