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 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.29.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.29.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.20190614-x86_64-ebs ami-0329a1fdc914b0c55 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-02507631a9f7bc956 Launch instance
us-west-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-0e7f661f69bb5d6b4 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-00e0090ac21971297 Launch instance
ap-east-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-01cb1066e1ad93cba Launch instance
ap-northeast-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-052f2fa11c7145e04 Launch instance
ap-northeast-2 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-0400d18ee6d078a95 Launch instance
ap-south-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-05af3f57a0b59fb78 Launch instance
ap-southeast-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-0e8baaccc62ee0a9f Launch instance
ap-southeast-2 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-01711df8fe87a6217 Launch instance
ca-central-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-04fc06e24a65297fb Launch instance
eu-central-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-09577c19fbe1bd7fa Launch instance
eu-north-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-0c788f17fd2f1f650 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-04a084a6d17d9816e Launch instance
eu-west-2 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-013b322dbc79e9a6a Launch instance
eu-west-3 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-071f4e4006f9c3211 Launch instance
sa-east-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-01569d819ef2d5743 Launch instance
us-gov-east-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-0d6839e319ca398b9 Launch instance
us-gov-west-1 amzn2-ami-ecs-hvm-2.0.20190614-x86_64-ebs ami-f6b1ca97 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.29.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.29.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.20190617-arm64-ebs ami-04d57166b412182ca Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-054c7523f88819252 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-06fe7e1b2c2e1c403 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-0d2bc2ef86b794322 Launch instance
ap-northeast-1 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-03c7481fbd861a309 Launch instance
ap-south-1 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-0e080da108f456eda Launch instance
ap-southeast-2 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-0e4f39dd120f55ab2 Launch instance
eu-central-1 amzn2-ami-ecs-hvm-2.0.20190617-arm64-ebs ami-0fe0d679d79cb2562 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.29.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.29.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.20190614-x86_64-ebs ami-02bb50f6d2a052856 Launch instance
us-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0d334c42a27f3518a Launch instance
us-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-081c9eb1157e6df56 Launch instance
us-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-07aecceb474f62374 Launch instance
ap-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-09b91ad3d83dfc37e Launch instance
ap-northeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0c1eb6a63ac3b9bb1 Launch instance
ap-northeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0300aabae97c41597 Launch instance
ap-south-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-07fac902ed2f0fc4f Launch instance
ap-southeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-097afb35fa0bbda8f Launch instance
ap-southeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-087dff31c28befb87 Launch instance
ca-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0a3f00e10b0b01fd6 Launch instance
eu-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-04a9fd81a4eb30837 Launch instance
eu-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0c48369105778c21a Launch instance
eu-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0fa8b2586dc0d989e Launch instance
eu-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0d5ad99ef46857019 Launch instance
eu-west-3 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-065a0ac9ffdf045ce Launch instance
sa-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-0d8c20b2ec35b644d Launch instance
us-gov-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-05470a522ce6d3be7 Launch instance
us-gov-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190614-x86_64-ebs ami-93bcc7f2 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.29.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.29.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.u-amazon-ecs-optimized ami-0eba5aab4550a443a Launch instance
us-east-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0d09143c6fc181fe3 Launch instance
us-west-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-00303cd65a37d033b Launch instance
us-west-2 amzn-ami-2018.03.u-amazon-ecs-optimized ami-084799b9fb64c149e Launch instance
ap-east-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-053d6ef319599211f Launch instance
ap-northeast-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0e1aa8c2e9d719f58 Launch instance
ap-northeast-2 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0765a9b4036f26f32 Launch instance
ap-south-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-09155a5dc3c532de1 Launch instance
ap-southeast-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0309369aa9694281c Launch instance
ap-southeast-2 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0c2963a1e04bd8a00 Launch instance
ca-central-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-00d5c6d1f8349edd1 Launch instance
eu-central-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0c0c01a7a42f41c0c Launch instance
eu-north-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-01d37f0c18610fdc6 Launch instance
eu-west-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-03d739ab8755ab020 Launch instance
eu-west-2 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0959f069afa43696a Launch instance
eu-west-3 amzn-ami-2018.03.u-amazon-ecs-optimized ami-025da470c90f48af8 Launch instance
sa-east-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-01c4f4ee99cf38e79 Launch instance
us-gov-east-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-0f85cbfbcffb10b08 Launch instance
us-gov-west-1 amzn-ami-2018.03.u-amazon-ecs-optimized ami-91b1caf0 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