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 SSM 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
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.27.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.27.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.20190402-x86_64-ebs ami-00cffcd24cb08edf1 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0bc08634af113cccb Launch instance
us-west-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-05cc68a00d392447a Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0054160a688deeb6a Launch instance
ap-northeast-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-00f839709b07ffb58 Launch instance
ap-northeast-2 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0470f8828abe82a87 Launch instance
ap-south-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0d143ad35f29ad632 Launch instance
ap-southeast-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0c5b69a05af2f0e23 Launch instance
ap-southeast-2 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-011ce3fbe73731dfe Launch instance
ca-central-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-039a05a64b90f63ee Launch instance
eu-central-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0ab1db011871746ef Launch instance
eu-north-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-036cf93383aba5279 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-09cd8db92c6bf3a84 Launch instance
eu-west-2 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-016a20f0624bae8c5 Launch instance
eu-west-3 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-0b4b8274f0c0d3bac Launch instance
sa-east-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-04e333c875fae9d77 Launch instance
us-gov-east-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-04002561557e6b65d Launch instance
us-gov-west-1 amzn2-ami-ecs-hvm-2.0.20190402-x86_64-ebs ami-c8c6b1a9 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.27.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.27.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.20190403-arm64-ebs ami-0b7373d6d90afa646 Launch instance
us-east-1 amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0a399f59161729e22 Launch instance
us-west-2 amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0db3030cf5c933348 Launch instance
eu-west-1 amzn2-ami-ecs-hvm-2.0.20190403-arm64-ebs ami-0c812cd5f7b956092 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.27.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.27.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.20190402-x86_64-ebs ami-083c800fe4211192f Launch instance
us-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-03e13a3b6e7815f1f Launch instance
us-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-03fc1e85125c026d1 Launch instance
us-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-05284b9aa3c01ab6b Launch instance
ap-northeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0b23c122484f8bf90 Launch instance
ap-northeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0b4cb7dc47ed8d637 Launch instance
ap-south-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-060e32be63fa1b286 Launch instance
ap-southeast-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0962019d4f4ce50a9 Launch instance
ap-southeast-2 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-03cc98c2bbe75bc58 Launch instance
ca-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-004fcd34a016ba693 Launch instance
cn-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-006004b7d4d7fd134 Launch instance
cn-northwest-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-06cc94b9803fe14f0 Launch instance
eu-central-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0a06003d7b855bfd3 Launch instance
eu-north-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0a1b9d94154abd70a Launch instance
eu-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0638eba79fcfe776e Launch instance
eu-west-2 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0190d74b4f308b3fa Launch instance
eu-west-3 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-04a041a6e222beb5c Launch instance
sa-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0027082516f6d0cda Launch instance
us-gov-east-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-0a99d51364f87002a Launch instance
us-gov-west-1 amzn2-ami-ecs-gpu-hvm-2.0.20190402-x86_64-ebs ami-58c6b139 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.27.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.27.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.p-amazon-ecs-optimized ami-0351a163d5f20e068 Launch instance
us-east-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0be9e1908fe51a590 Launch instance
us-west-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0860832102c806acb Launch instance
us-west-2 amzn-ami-2018.03.p-amazon-ecs-optimized ami-01a82c3fce2c3ba58 Launch instance
ap-northeast-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-047281402e27cf0c5 Launch instance
ap-northeast-2 amzn-ami-2018.03.p-amazon-ecs-optimized ami-07ef5505ecca20315 Launch instance
ap-south-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0cf953afde70921a2 Launch instance
ap-southeast-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-04e47a1e7ce1d448a Launch instance
ap-southeast-2 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0f0ba4af21d1e1766 Launch instance
ca-central-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0e73429acd3865bd2 Launch instance
cn-north-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0da0590b87d9022f2 Launch instance
cn-northwest-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0262c8e755ee0b0cf Launch instance
eu-central-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-02c40c6d994943b85 Launch instance
eu-north-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0719a9312994ac2cb Launch instance
eu-west-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0f85d8192f90863dc Launch instance
eu-west-2 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0bf096cb3ddbdffe0 Launch instance
eu-west-3 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0a6720df6a8239525 Launch instance
sa-east-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0656fd0f926c55fc6 Launch instance
us-gov-east-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-0c6b0b15e70eb6f3e Launch instance
us-gov-west-1 amzn-ami-2018.03.p-amazon-ecs-optimized ami-22d3a443 Launch instance
Windows

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

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

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.