| docker-credential-desktop |
error getting credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH |
~/.docker/config.json tells Docker to use a credential helper (desktop, osxkeychain, wincred) that isn’t inst… |
| did not complete successfully |
failed to solve: process "/bin/sh -c ..." did not complete successfully: exit code: 1 |
A RUN step in your Dockerfile failed. The real error is printed in the lines just above this message. |
| lookup registry-1.docker.io: no such host |
dial tcp: lookup registry-1.docker.io: no such host / Temporary failure in name resolution during docker build |
DNS isn’t working for the Docker daemon or inside build containers, so pulls and package downloads fail. |
| denied |
denied: requested access to the resource is denied (docker push) |
You’re logged in, but not allowed to push to that repository — usually the image isn’t tagged with your own u… |
| Mounts denied |
Docker Desktop: Mounts denied: The path is not shared from the host and is not known to Docker |
Docker Desktop (macOS) can only bind-mount folders listed under Settings → Resources → File sharing. |
| pull access denied |
pull access denied for image, repository does not exist or may require 'docker login' |
Docker couldn’t pull the image: the name or tag is wrong, the repository is private and you’re not logged in,… |
| docker-compose: command not found |
docker-compose: command not found / 'compose' is not a docker command |
Your system has only one of the two Compose flavours: the old docker-compose (v1) binary or the newer docker… |
| Pool overlaps |
Error response from daemon: Pool overlaps with other one on this address space |
Docker tried to create a network whose subnet clashes with an existing Docker network (or a VPN/host route). |
| is not running |
Error response from daemon: Container X is not running |
You tried to exec into or interact with a container that has stopped. |
| failed to read dockerfile |
failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory |
docker build can’t find a Dockerfile in the build context you passed. |
| Client.Timeout exceeded |
Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded) |
Docker couldn’t reach the registry in time — a network, DNS, proxy or firewall problem between your machine a… |
| port is already allocated |
Docker: Bind for 0.0.0.0:80 failed: port is already allocated |
Another container or host process already publishes that host port. |
| unknown instruction |
Dockerfile parse error line N: unknown instruction |
A line in the Dockerfile doesn’t start with a valid instruction — usually a broken line continuation or a typ… |
| Error saving credentials |
Error saving credentials: error storing credentials - err: exit status 1 |
docker login authenticated, but the credential helper (keychain, pass, wincred) couldn’t store the password. |
| bind source path does not exist |
invalid mount config for type "bind": bind source path does not exist |
A -v/--mount or Compose volume points at a host path that doesn’t exist (from the Docker daemon’s point of vi… |
| executable file not found in $PATH |
OCI runtime create failed: exec: "x": executable file not found in $PATH |
The command you asked the container to run doesn’t exist inside the image — wrong command name, a shell that… |
| the input device is not a TTY |
the input device is not a TTY |
docker run/exec was called with -t (allocate a terminal) in a context with no terminal — CI, cron, a pipe or… |
| unauthorized: authentication required |
unauthorized: authentication required (docker push / pull) |
The registry needs credentials for this operation and the request had none or had expired ones. |
| daemon |
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? |
The docker CLI can’t talk to the Docker engine — it isn’t running, or your user can’t access the socket. |
| compose validation |
docker compose: services.x Additional property y is not allowed / yaml: line N: mapping values are not allowed |
The compose file is invalid YAML or uses a key Compose doesn’t recognise at that level (usually an indentatio… |
| iptables: No chain/target/match |
driver failed programming external connectivity on endpoint: iptables: No chain/target/match by that name |
Docker’s iptables rules were wiped (firewalld/ufw reload, iptables flush) while Docker was running, so it can… |
| exec permission denied |
exec /entrypoint.sh: permission denied (container won't start) |
The entrypoint or command isn’t marked executable inside the image, or it’s on a volume mounted noexec. |
| conflict: unable to remove repository reference |
conflict: unable to remove repository reference (must force) - container is using its referenced image |
You tried to delete an image that a container — even a stopped one — still uses. |
| COPY failed |
COPY failed: file not found in build context / "/app/x": not found |
The Dockerfile COPY refers to a path outside the build context, excluded by .dockerignore, or relative to the… |
| WSL 2 installation is incomplete |
Docker Desktop: WSL 2 installation is incomplete / WSL update required |
Docker Desktop on Windows needs WSL 2 and its Linux kernel; they’re missing, outdated or disabled. |
| manifest unknown |
manifest for image:tag not found: manifest unknown |
The repository exists, but the tag you asked for doesn’t — it was never pushed, was deleted, or is misspelled. |
| ENOSPC |
no space left on device (Docker / Linux) |
The disk (or inode table) is full — Docker images, build cache, logs and volumes are common culprits. |
| permission denied (volume) |
Permission denied writing to a mounted volume inside a Docker container |
The process inside the container runs as a user (UID) that doesn’t own the bind-mounted host folder, so reads… |
| depends on undefined service |
service "web" depends on undefined service "db": invalid compose project |
A service lists depends_on (or links/networks) for a service name that isn’t defined in the Compose file(s) b… |
| Conflict container name |
Conflict. The container name "/x" is already in use by container … |
A container (running or stopped) already has that name; Docker won’t create a second one with the same name. |
| unhealthy |
Docker container is unhealthy (health check failing) |
The container is running, but its HEALTHCHECK command keeps failing, so Docker (and dependent services) consi… |
| invalid reference format |
docker: invalid reference format (repository name must be lowercase) |
Docker couldn’t parse the image name — uppercase letters, spaces, an empty variable, or a misplaced option. |
| max depth exceeded |
Error response from daemon: max depth exceeded (too many image layers) |
The image has more layers than the storage driver allows (127 for overlay2), usually from repeatedly committi… |
| toomanyrequests |
toomanyrequests: You have reached your pull rate limit (Docker Hub) |
Docker Hub limits anonymous and free pulls; your IP or account has used its quota for the current window. |
| the attribute version is obsolete |
WARN: the attribute `version` is obsolete, it will be ignored |
A harmless Compose v2 warning: the top-level version: line in docker-compose.yml is no longer used. |
| forbidden path outside the build context |
COPY failed: forbidden path outside the build context: ../file |
A COPY/ADD tries to read a file above the build context (../something); Docker only sends the context folder… |
| Restarting (1) |
Docker container keeps restarting (Restarting (1) x seconds ago) |
The container crashes on start and its restart policy (always/unless-stopped/on-failure) starts it again in a… |
| client version is too new |
Error response from daemon: client version 1.45 is too new. Maximum supported API version is 1.41 |
Your Docker CLI (or SDK) speaks a newer API version than the Docker daemon it’s talking to. |
| exec no such file or directory |
exec /docker-entrypoint.sh: no such file or directory (CRLF line endings / missing interpreter) |
The entrypoint file exists, but the kernel can’t run it — almost always Windows CRLF line endings in the scri… |
| Exited (0) |
Docker container exits immediately (Exited (0) / Exited (1) right after start) |
The container started and its main process finished at once, so the container stopped — Docker containers onl… |
| No such container |
Error response from daemon: No such container |
The container name or ID you used doesn’t exist on this Docker host — it was removed, has another name, or yo… |
| You cannot remove a running container |
Error response from daemon: You cannot remove a running container. Stop the container before attempting removal or force remove |
docker rm refuses to delete a container that is still running. |
| http: server gave HTTP response to HTTPS client |
http: server gave HTTP response to HTTPS client (insecure registry) |
Docker spoke HTTPS to a registry that only serves plain HTTP — typically a local or lab registry. |
| image has dependent child images |
conflict: unable to delete image (cannot be forced) - image has dependent child images |
Other images were built on top of this one, so Docker won’t delete it by ID. |
| Sending build context |
Docker build slow: "Sending build context to Docker daemon 2.5GB" / transferring context takes forever |
docker build is uploading your whole project folder — node_modules, .git, data files — before building, becau… |
| incorrect username or password |
Error response from daemon: Get "https://registry-1.docker.io/v2/": unauthorized: incorrect username or password |
docker login was rejected — wrong credentials, or the account requires an access token instead of the passwor… |
| network not found |
Error response from daemon: network X not found |
The container or Compose project refers to a Docker network that doesn’t exist (any more). |
| exec format error |
exec /usr/local/bin/docker-entrypoint.sh: exec format error |
The container tried to run a binary built for a different CPU architecture (arm64 vs amd64) — or a script wit… |
| no matching manifest |
no matching manifest for linux/arm64/v8 in the manifest list entries |
The image has no build for your CPU architecture — typically pulling an amd64-only image on an Apple Silicon… |
| x509: certificate signed by unknown authority |
x509: certificate signed by unknown authority (docker pull/login) |
The registry’s TLS certificate isn’t trusted by the Docker daemon — a private CA, self-signed certificate, or… |
| could not select device driver |
could not select device driver "" with capabilities: [[gpu]] |
docker run --gpus was used, but the NVIDIA Container Toolkit isn’t installed/configured, so Docker can’t expo… |