Skip to content

Getting Started

Get up and running with AWS Deep Learning Containers quickly.

Prerequisites

  • An AWS account with appropriate permissions
  • Docker installed on your local machine
  • AWS CLI configured with your credentials

Pulling Images

Learn how to authenticate and pull AWS Deep Learning Containers images.

Authentication

aws ecr get-login-password --region <region> | docker login --username AWS --password-stdin <account_id>.dkr.ecr.<region>.amazonaws.com

Then pull images:

docker pull <account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>

Image URL Format

To form your container image URL, use the following format:

<account_id>.dkr.ecr.<region>.amazonaws.com/<repository>:<tag>

Where:

  • <account_id>: Find the account ID for your region in the Region Availability table
  • <region>: Your AWS region (e.g., us-east-1, us-west-2, eu-west-1)
  • <repository>: The framework repository name (e.g., pytorch-training, tensorflow-inference)
  • <tag>: The image tag from the Available Images tables

Example

# Authenticate
aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 763104351884.dkr.ecr.us-west-2.amazonaws.com

# Pull PyTorch training image
docker pull 763104351884.dkr.ecr.us-west-2.amazonaws.com/pytorch-training:2.9.0-cpu-py312-ubuntu22.04-ec2

Next Steps

After completing the getting started guides, explore our tutorials for more advanced use cases.