docker / image-not-found

docker image not found / repository does not exist — how to fix

Quick Answer

# Pull explicitly before running
docker pull nginx:latest

# Check available tags on Docker Hub
# https://hub.docker.com/_/nginx/tags

# Log in to a private registry
docker login registry.example.com

# Verify local images
docker images | grep nginx

When this happens

Unable to find image 'myapp:latest' locally
docker: Error response from daemon: pull access denied for myapp,
repository does not exist or may require 'docker login':
denied: requested access to the resource is denied.

Docker could not find the image locally or on the registry. This is usually a typo in the image name/tag or a missing registry login.

Other causes & fixes

Build the image locally first

# Build from Dockerfile in current directory
docker build -t myapp:latest .

# Then run it
docker run myapp:latest

Specify the full registry path

# Docker Hub (implicit)
docker pull nginx:1.27-alpine

# GitHub Container Registry
docker pull ghcr.io/owner/repo:tag

# AWS ECR
aws ecr get-login-password | docker login --username AWS --password-stdin 123456789.dkr.ecr.us-east-1.amazonaws.com
docker pull 123456789.dkr.ecr.us-east-1.amazonaws.com/my-repo:latest

List all locally available images

docker images
# or filter by name
docker images nginx

Related