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

• 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.1-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.20190709-x86_64-ebs	ami-0dca97e7cde7be3d5	Launch instance
us-east-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0fac5486e4cff37f4	Launch instance
us-west-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0c6e63b58aac1048e	Launch instance
us-west-2	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0e5e051fd0b505db6	Launch instance
ap-east-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-02252d984c7e3595d	Launch instance
ap-northeast-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-04a735b489d2a0320	Launch instance
ap-northeast-2	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0accbb5aa909be7bf	Launch instance
ap-south-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0a8bf4e187339e2c1	Launch instance
ap-southeast-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-05c6d22d98f97471c	Launch instance
ap-southeast-2	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-039bb4c3a7946ce19	Launch instance
ca-central-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-01c07ee95e77abba8	Launch instance
eu-central-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0650e7d86452db33b	Launch instance
eu-north-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-059aa04f0c253ad6b	Launch instance
eu-west-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0ae254c8a2d3346a7	Launch instance
eu-west-2	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0de1dc478496a9e9b	Launch instance
eu-west-3	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0d260f3e5ccd06043	Launch instance
sa-east-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-038707d64e5b8e7ba	Launch instance
us-gov-east-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0a224902b35f8ad6c	Launch instance
us-gov-west-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-04c68165	Launch instance
cn-north-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0b619dec66f0fe1eb	Launch instance
cn-northwest-1	amzn2-ami-ecs-hvm-2.0.20190709-x86_64-ebs	ami-0b619dec66f0fe1eb	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.1)

• 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.1-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.20190709-arm64-ebs	ami-02a59fb754c85ab16	Launch instance
us-east-1	amzn2-ami-ecs-hvm-2.0.20190709-arm64-ebs	ami-0b3b892651e52f03d	Launch instance
us-west-2	amzn2-ami-ecs-hvm-2.0.20190709-arm64-ebs	ami-0860edcdc9c9533e3	Launch instance
eu-west-1	amzn2-ami-ecs-hvm-2.0.20190709-arm64-ebs	ami-0af65bdd9a59a3171	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.1)

• 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.1-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.20190709-x86_64-ebs	ami-0522cd69e8a331c8a	Launch instance
us-east-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0875a1e6c2db1cdc9	Launch instance
us-west-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0dfe31c7ed6577ebf	Launch instance
us-west-2	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0bf12263037af5756	Launch instance
ap-east-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0efcda0accbf5a0f4	Launch instance
ap-northeast-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-041843b72dde36df4	Launch instance
ap-northeast-2	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0e18b01ac7608adcd	Launch instance
ap-south-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0c5cdf93d467beca8	Launch instance
ap-southeast-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-07b25dd477ea57f82	Launch instance
ap-southeast-2	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-07f990e4e7551b774	Launch instance
ca-central-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-08e1aab6a2cfd879d	Launch instance
eu-central-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-096ccf1edd625875e	Launch instance
eu-north-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0576489203c1c4ccc	Launch instance
eu-west-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-03867df65b0e5ab52	Launch instance
eu-west-2	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0faecf24ba37edfce	Launch instance
eu-west-3	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0dec5973b167d5ff3	Launch instance
sa-east-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0a398510537094972	Launch instance
us-gov-east-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0365a6c905c4ba391	Launch instance
us-gov-west-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-f8b8ff99	Launch instance
cn-north-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-01143a340285bc1fb	Launch instance
cn-northwest-1	amzn2-ami-ecs-gpu-hvm-2.0.20190709-x86_64-ebs	ami-0240ef2b16197fef3	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.1)

• 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.1-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.v-amazon-ecs-optimized	ami-0151b45908571e14c	Launch instance
us-east-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0c09d65d2051ada93	Launch instance
us-west-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0b4f28359911d5896	Launch instance
us-west-2	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-077368b501184adb9	Launch instance
ap-east-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0eeaf74d330e7e8ca	Launch instance
ap-northeast-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-084d4626fec6f3ca3	Launch instance
ap-northeast-2	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-03c5d1f1ba6ec1b7d	Launch instance
ap-south-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-09f6bc049f323302c	Launch instance
ap-southeast-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-01813416d767d88db	Launch instance
ap-southeast-2	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-07fcafbb9f3a4f7db	Launch instance
ca-central-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-011742239f8f42f46	Launch instance
eu-central-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0bceb1887b6b37130	Launch instance
eu-north-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0d7012b0cae33c045	Launch instance
eu-west-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-02b9d5ef54d57fb7d	Launch instance
eu-west-2	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0f49b2a9014635082	Launch instance
eu-west-3	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0db8d6e7dcf3cb362	Launch instance
sa-east-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0ad0be326813dda96	Launch instance
us-gov-east-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-033b28d8ef5fe3f73	Launch instance
us-gov-west-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-b0bafdd1	Launch instance
cn-north-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-041f913b515304af9	Launch instance
cn-northwest-1	amzn-ami-2018.03.v-amazon-ecs-optimized	ami-0be42f3b41b17b513	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.8

• Amazon ECS container agent version 1.29.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.07.19	ami-05c650b3e1759298f	Launch instance
us-east-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-00f3f16f1d05e53a9	Launch instance
us-west-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-08f56c127cc9ae9c4	Launch instance
us-west-2	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0c37f25e59d752c61	Launch instance
ap-northeast-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0771bfb73bc362295	Launch instance
ap-northeast-2	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0849ba95174008d74	Launch instance
ap-south-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0dfe1bb9ed2dd2ff1	Launch instance
ap-southeast-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-06daa78e84b800914	Launch instance
ap-southeast-2	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-071e43d09ba6f2479	Launch instance
ca-central-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0ed093f8cd0bb6f64	Launch instance
eu-central-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-020bded18f4df2c7d	Launch instance
eu-north-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0269f4d7fa129ddcb	Launch instance
eu-west-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0e3604f46f9ccc506	Launch instance
eu-west-2	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0746c037f8889f6e8	Launch instance
eu-west-3	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-022ae3cb06a066371	Launch instance
sa-east-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-094ff1452e5849bff	Launch instance
us-gov-east-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0e238cac0ef640949	Launch instance
us-gov-west-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-13fcbd72	Launch instance
cn-north-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-02728cc741b470390	Launch instance
cn-northwest-1	Windows_Server-2019-English-Full-ECS_Optimized-2019.07.19	ami-0e1cafc0e9ae3faf8	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.09.8

• Amazon ECS container agent version 1.29.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.07.19	ami-0ca3903548e4a8681	Launch instance
us-east-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0831d21a034cb33e4	Launch instance
us-west-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-08b04db86cc171254	Launch instance
us-west-2	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0b380fdc264da2fc3	Launch instance
ap-northeast-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0d3f659d5bab5c8e5	Launch instance
ap-northeast-2	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0d4fe34a4a5cb98ba	Launch instance
ap-south-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0add8558b7afe4960	Launch instance
ap-southeast-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-001b756da3bc2770c	Launch instance
ap-southeast-2	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-063f16052f2b588a2	Launch instance
ca-central-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-07cc1c48c86d988ca	Launch instance
eu-central-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0644eb70b836aa55a	Launch instance
eu-north-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-038a1a6d22e486228	Launch instance
eu-west-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0e41be650397b131d	Launch instance
eu-west-2	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0884e795ec6511040	Launch instance
eu-west-3	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-03f921d23a15ff701	Launch instance
sa-east-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-06955dc02fc2a3b7b	Launch instance
us-gov-east-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-04c0f4fe213678f9b	Launch instance
us-gov-west-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-38fdbc59	Launch instance
cn-north-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-010da5256208bcb66	Launch instance
cn-northwest-1	Windows_Server-2016-English-Full-ECS_Optimized-2019.07.19	ami-0c1033d4d46070747	Launch instance

Topics

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