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.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

Topics

• How to Launch the Latest Amazon ECS-Optimized Amazon Linux AMI
• Amazon ECS-optimized AMI Versions
• AMI Storage Configuration