How to select a base image URI - Amazon EMR

How to select a base image URI

The base Docker images you can select are stored in Amazon Elastic Container Registry (Amazon ECR). The image URI follows this format:, as the following example demonstrates.

The image URI for managed endpoints follows this format:, as the following example demonstrates. You need to use notebook-spark in the base image URI, instead of spark.

Use the information in the following table to select a container image tag for your base image.


Beginning with Amazon EMR release version 6.3.0, you can use an image tag with :latest to automatically get the latest base images in each build. If you are using an older Amazon EMR release, make sure to use the base image tag with the latest date. For example, emr-6.2.0-20210129.

Releases Amazon EMR on EKS release versions Container image tags
Amazon EMR 6.3.0 releases emr-6.3.0-latest emr-6.3.0:latest
emr-6.3.0-20210429 emr-6.3.0:20210429
Amazon EMR 6.2.0 releases emr-6.2.0-latest emr-6.2.0-20210129
emr-6.2.0-20210129 emr-6.2.0-20210129
emr-6.2.0-20201218 emr-6.2.0-20201218
emr-6.2.0-20201201 emr-6.2.0-20201201
Amazon EMR 5.33.0 releases emr-5.33.0-latest emr-5.33.0-20210323
emr-5.33.0-20210323 emr-5.33.0-20210323
Amazon EMR 5.32.0 releases emr-5.32.0-latest emr-5.32.0-20210129
emr-5.32.0-20210129 emr-5.32.0-20210129
emr-5.32.0-20201218 emr-5.32.0-20201218
emr-5.32.0-20201201 emr-5.32.0-20201201

To avoid high network latency, you should pull a base image from your closest AWS Region. Select the Amazon ECR registry account corresponding to the Region you are pulling the image from based on the following table.

Regions Amazon ECR registry accounts
ap-northeast-1 059004520145
ap-northeast-2 996579266876
ap-south-1 235914868574
ap-southeast-1 671219180197
ap-southeast-2 038297999601
ca-central-1 351826393999
eu-central-1 107292555468
eu-north-1 830386416364
eu-west-1 483788554619
eu-west-2 118780647275
eu-west-3 307523725174
sa-east-1 052806832358
us-east-1 755674844232
us-east-2 711395599931
us-west-1 608033475327
us-west-2 895885662937