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

How to Launch the Latest Amazon ECS-Optimized Amazon Linux AMI

The following are several ways that you can launch the latest Amazon ECS-optimized AMI into your cluster:

  • The Amazon ECS console first-run wizard launches your container instances with the latest Amazon ECS-optimized AMI. For more information, see Getting Started with Amazon ECS.

  • You can launch your container instances manually in the Amazon EC2 console by following the procedures in Launching an Amazon ECS Container Instance. You could also choose the EC2 Console Link in one of the tables below that corresponds to your cluster's region.

  • You can retrieve the current Amazon ECS-optimized AMI programmatically using the Systems Manager API. For more information, see Retrieving Amazon ECS-Optimized AMI Metadata.

  • Use the current Amazon ECS-optimized AMI ID, according to the variant you choose, below to launch your instance using the AWS CLI, the AWS SDKs, or an AWS CloudFormation template.

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.30.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.30.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.20190815-x86_64-ebs ami-0e7c12c1bedd6bf21 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-0b16d80945b1a9c7d Launch instance
us-west-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-08a12265d9e050d57 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-0e434a58221275ed4 Launch instance
ap-east-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-05bfc466e50bdfb65 Launch instance
ap-northeast-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-0e37e42dff65024ae Launch instance
ap-northeast-2 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-000fbda700ba8fe9d Launch instance
ap-south-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-0b7f1d57770573a75 Launch instance
ap-southeast-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-05357ea4dad5e2cf4 Launch instance
ap-southeast-2 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-0c7dea114481e059d Launch instance
ca-central-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-052de4ecee980719c Launch instance
eu-central-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-0e1d30823ff9f8459 Launch instance
eu-north-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-063b45c1e31fdc5d2 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-02bf9e90a6e30dc74 Launch instance
eu-west-2 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-010624faf51b049d3 Launch instance
eu-west-3 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-084e49fa6ca9c8794 Launch instance
sa-east-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-051d98f19acea0389 Launch instance
us-gov-east-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-083cf4d1d5ca46c23 Launch instance
us-gov-west-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-8d511eec Launch instance
cn-north-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-03e4887abba02fadb Launch instance
cn-northwest-1 amzn2-ami-ecs-hvm-2.0.20190815-x86_64-ebs ami-00a7b74b1f028cf0d 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.30.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.30.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.20190815-arm64-ebs ami-036f6ddd491fd6009 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190815-arm64-ebs ami-01a325c826e291b64 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190815-arm64-ebs ami-070f0c8512914277a Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190815-arm64-ebs ami-07e41fbf04f9e0d6b 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.30.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.30.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.20190815-x86_64-ebs ami-0d9a105d85d46ce21 Launch instance
us-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0180e79579e32b7e6 Launch instance
us-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0f2d4e4a159b148a9 Launch instance
us-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0a795f51aebcbe0c1 Launch instance
ap-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0a1476f135fcd55c8 Launch instance
ap-northeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0b347740f06f9dd72 Launch instance
ap-northeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-093f2e63de5d4b480 Launch instance
ap-south-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-06b37b182941ed228 Launch instance
ap-southeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-08d4d1bc5d79e56cf Launch instance
ap-southeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-005ff23ea5572250c Launch instance
ca-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0b975c72ed95864d8 Launch instance
eu-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-08430f68d6875a40a Launch instance
eu-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0f844d07a837de7e8 Launch instance
eu-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0a5532e0793a984d9 Launch instance
eu-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-016ba03f07656e55b Launch instance
eu-west-3 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-09d347753b8ee2d64 Launch instance
sa-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0aa505607f459a952 Launch instance
us-gov-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0ce1af554c76dfa4f Launch instance
us-gov-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-05511e64 Launch instance
cn-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-0645a2a7685225a80 Launch instance
cn-northwest-1 amzn2-ami-ecs-gpu-hvm-2.0.20190815-x86_64-ebs ami-01e13577489b67d12 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.30.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.30.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.w-amazon-ecs-optimized ami-035a1bdaf0e4bf265 Launch instance
us-east-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-066ce9bb9f4cbb03d Launch instance
us-west-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0413317a44231a219 Launch instance
us-west-2 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0fd6e28e415664140 Launch instance
ap-east-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0bc9197107aa2e36d Launch instance
ap-northeast-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0a4b5b999281c955b Launch instance
ap-northeast-2 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0c6e04cbad6e3e13f Launch instance
ap-south-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-04a56cb1908b6ce94 Launch instance
ap-southeast-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-003cb73efe1eb03cc Launch instance
ap-southeast-2 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0112bb4988eedc594 Launch instance
ca-central-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-02a835991f91d92cb Launch instance
eu-central-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0b0a910db6581d75f Launch instance
eu-north-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-03147f238a3100ad7 Launch instance
eu-west-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0d2aaec13a6b7e7ca Launch instance
eu-west-2 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0e2d2ad19e82df43b Launch instance
eu-west-3 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0244cc5d7b6e6d95e Launch instance
sa-east-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-0149bb9bc7a19cf0e Launch instance
us-gov-east-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-09c03f1d4c50330f7 Launch instance
us-gov-west-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-ac521dcd Launch instance
cn-north-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-099eefd6de9767dd1 Launch instance
cn-northwest-1 amzn-ami-2018.03.w-amazon-ecs-optimized ami-009c89a26befaa039 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

For more information about previous versions and the corresponding Docker and Amazon ECS container agent versions, see Amazon ECS-Optimized Amazon Linux AMI Container Agent Versions.