Sign In to the Console
Amazon Elastic Container Service
Developer Guide (API Version 2014-11-13)

AWS Documentation » Amazon ECS » Developer Guide » Amazon ECS Container Instances » Amazon ECS-optimized AMIs

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 AMI – Recommended for launching your Amazon ECS container instances on the Windows operating system. For more information, see Windows Containers.

  • Amazon ECS-optimized Windows 2016 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 ID, 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 2019Windows Server 2016
Amazon Linux 2

The current Amazon ECS-optimized Amazon Linux 2 AMI consists of:

  • The latest minimal version of the Amazon Linux 2

  • The latest version of the Amazon ECS container agent (1.28.0)

  • The recommended version of Docker for the latest Amazon ECS container agent (18.06.1-ce)

  • The latest version of the ecs-init package to run and monitor the Amazon ECS agent (1.28.0-1)

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

Region AMI Name AMI ID EC2 Console Link
us-east-2 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-012ca23958772cf72 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-00cf4737e238866a3 Launch instance
us-west-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-06d87f0156b1d4407 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0a9f5be2a016dccad Launch instance
ap-east-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-067f4f7124e746edd Launch instance
ap-northeast-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0e52aad6ac7733a6a Launch instance
ap-northeast-2 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-08834c8c57e502d6d Launch instance
ap-south-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-04322e867758d97a8 Launch instance
ap-southeast-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0047bfdb16f1f6781 Launch instance
ap-southeast-2 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-09475847322e5566f Launch instance
ca-central-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0498c464ec4d2ba83 Launch instance
eu-central-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-096a38c97b80cd8ec Launch instance
eu-north-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0dddc4daca44e6e99 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0c5abd45f676aab4f Launch instance
eu-west-2 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-0204aa6a92a54561e Launch instance
eu-west-3 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-07273195833e4f20c Launch instance
sa-east-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-00d851648873aaabc Launch instance
us-gov-east-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-06473be43b0f77600 Launch instance
us-gov-west-1 amzn2-ami-ecs-hvm-2.0.20190510-x86_64-ebs ami-607c0001 Launch instance
Amazon Linux 2 (arm64)

The current Amazon ECS-optimized Amazon Linux 2 (arm64) AMI consists of:

  • The latest minimal version of the Amazon Linux 2

  • The latest version of the Amazon ECS container agent (1.28.0)

  • The recommended version of Docker for the latest Amazon ECS container agent (18.06.1-ce)

  • The latest version of the ecs-init package to run and monitor the Amazon ECS agent (1.28.0-1)

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

Region AMI Name AMI ID EC2 Console Link
us-east-2 amzn2-ami-ecs-hvm-2.0.20190510-arm64-ebs ami-030392040d1aed930 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190510-arm64-ebs ami-0e7126260e3c3f9b0 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190510-arm64-ebs ami-037a4247c72ff5782 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190510-arm64-ebs ami-04d7703e789babb4a Launch instance
Amazon Linux 2 (GPU)

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

  • The latest minimal version of the Amazon Linux 2

  • The latest version of the Amazon ECS container agent (1.28.0)

  • The recommended version of Docker for the latest Amazon ECS container agent (18.06.1-ce)

  • The latest version of the ecs-init package to run and monitor the Amazon ECS agent (1.28.0-1)

  • 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 AMI Name AMI ID EC2 Console Link
us-east-2 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0f132b270b9aabeca Launch instance
us-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0b0ae551a867891da Launch instance
us-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0ca127ab2bfadf65d Launch instance
us-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-083612cfef21db11d Launch instance
ap-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0ce92ebe7a58225a8 Launch instance
ap-northeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0a090420c9bdbd47f Launch instance
ap-northeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0aa98500408657f87 Launch instance
ap-south-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-06eec8c54f8a637e9 Launch instance
ap-southeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-03893996ba1620bc0 Launch instance
ap-southeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-01d49902dbdd24819 Launch instance
ca-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-00136313cb23e1bcd Launch instance
cn-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0eda13fcf629f5f0c Launch instance
cn-northwest-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0a004e87a7189cdf3 Launch instance
eu-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0123f684a7258c751 Launch instance
eu-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-051ff72fce0a8bafe Launch instance
eu-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0ba990e211024cbff Launch instance
eu-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-0bae1ac39b3ab1c25 Launch instance
eu-west-3 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-06d9106a2e6079a8b Launch instance
sa-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-01eec887a06c2d4bf Launch instance
us-gov-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-05dcc99800a097fb5 Launch instance
us-gov-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190510-x86_64-ebs ami-bd7b07dc Launch instance
Amazon Linux AMI

The current Amazon ECS-optimized Amazon Linux AMI consists of:

  • The latest minimal version of the Amazon Linux AMI

  • The latest version of the Amazon ECS container agent (1.28.0)

  • The recommended version of Docker for the latest Amazon ECS container agent (18.06.1-ce)

  • The latest version of the ecs-init package to run and monitor the Amazon ECS agent (1.28.0-1)

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

Region AMI Name AMI ID EC2 Console Link
us-east-2 amzn-ami-2018.03.q-amazon-ecs-optimized ami-06a8ae0ecd30e804c Launch instance
us-east-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0750ab1027b6314c7 Launch instance
us-west-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-03fe84be94ca9cc17 Launch instance
us-west-2 amzn-ami-2018.03.q-amazon-ecs-optimized ami-043c4e6bff652b99e Launch instance
ap-east-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0d772c70a2d689e8b Launch instance
ap-northeast-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-062ef2a2561c9364a Launch instance
ap-northeast-2 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0005600074f3aa4be Launch instance
ap-south-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0a80c5ae873c08c64 Launch instance
ap-southeast-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0b78efd7fafc3f93a Launch instance
ap-southeast-2 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0c5058003c511da15 Launch instance
ca-central-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0005ff694f167b58a Launch instance
cn-north-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0005ce40ccef58b98 Launch instance
cn-northwest-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0066a513748afa1e0 Launch instance
eu-central-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-06a20f16dd2f50741 Launch instance
eu-north-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-087de2c1b54c6bd93 Launch instance
eu-west-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-09b156894255325fe Launch instance
eu-west-2 amzn-ami-2018.03.q-amazon-ecs-optimized ami-03ca259ae4cb86837 Launch instance
eu-west-3 amzn-ami-2018.03.q-amazon-ecs-optimized ami-055c29a7d5fc2d4a8 Launch instance
sa-east-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0d83f147ba8afa3cf Launch instance
us-gov-east-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-0b93f4db7ff03a1b1 Launch instance
us-gov-west-1 amzn-ami-2018.03.q-amazon-ecs-optimized ami-e97a0688 Launch instance
Windows Server 2019

The current Amazon ECS-optimized Windows 2019 AMI consists of:

  • The latest version of Microsoft Windows Server 2019

  • Docker EE version 18.09.4

  • Amazon ECS container agent version 1.27.0

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

Region AMI Name AMI ID EC2 Console Link
us-east-2 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0a4548e9bef884a63 Launch instance
us-east-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0f7cc2a4e9cb93130 Launch instance
us-west-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0caa9f58a76b75d76 Launch instance
us-west-2 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-09a6b4fc9786621ef Launch instance
ap-northeast-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0de9f680eb139f5f2 Launch instance
ap-northeast-2 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-052dc171cf22efb2c Launch instance
ap-south-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0fda456670ecdda47 Launch instance
ap-southeast-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0d073901cb231d495 Launch instance
ap-southeast-2 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-06cef3b9805e5ebb0 Launch instance
ca-central-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-09f37f76841876c2b Launch instance
cn-north-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-02942c66816678482 Launch instance
cn-northwest-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-066eff0f2473d2ba3 Launch instance
eu-central-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-09bff64c8c3102238 Launch instance
eu-north-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-078d39ec1c8b11d6b Launch instance
eu-west-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-05da69b2d804943e6 Launch instance
eu-west-2 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-01fbd6d84ec8b36d3 Launch instance
eu-west-3 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0a64405322f93a0c7 Launch instance
sa-east-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0ac8048de25ce4284 Launch instance
us-gov-east-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-0c4c54ea7fe80d45a Launch instance
us-gov-west-1 Windows_Server-2019-English-Full-ECS_Optimized-2019.05.10 ami-d91f63b8 Launch instance
Windows Server 2016

The current Amazon ECS-optimized Windows 2016 AMI consists of:

  • The latest version of Microsoft Windows Server 2016

  • Docker EE version 18.03.1-ee-7

  • Amazon ECS container agent version 1.26.0

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

Region AMI Name AMI ID EC2 Console Link
us-east-2 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-00c56e74f090d6f65 Launch instance
us-east-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0ed2f29599018e745 Launch instance
us-west-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-01b55f7fe967f727b Launch instance
us-west-2 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-07f6b98dc6c8067c3 Launch instance
ap-northeast-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-07839df9eec55ac8d Launch instance
ap-northeast-2 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-071b78467d9d35580 Launch instance
ap-south-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0183732d8e0fd56c7 Launch instance
ap-southeast-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0a6c13d83c0fdbf2b Launch instance
ap-southeast-2 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-06d33f81ca8384556 Launch instance
ca-central-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-098ad73a3005be676 Launch instance
cn-north-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0b484446add9a27b3 Launch instance
cn-northwest-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-047cc7df873d123f2 Launch instance
eu-central-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0f7386282aa13a0d8 Launch instance
eu-north-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-06e3cb4d2875b172e Launch instance
eu-west-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-04a2fa8ce0fc20c61 Launch instance
eu-west-2 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0fac4f3bdab9ccddc Launch instance
eu-west-3 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-06a5b6fc522511993 Launch instance
sa-east-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-05889298c47e6d5c2 Launch instance
us-gov-east-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-0b6f703732ae49d69 Launch instance
us-gov-west-1 Windows_Server-2016-English-Full-ECS_Optimized-2019.03.07 ami-9d91fafc Launch instance

Topics