docker config_error ai_generated true

Error response from daemon: invalid reference format: repository name must be lowercase

ID: docker/invalid-reference-format

Also available as: JSON · Markdown · 中文
95%Fix Rate
90%Confidence
1Evidence
2024-03-05First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
Docker 24.0.6 active — — —
Docker 25.0.3 active — — —
Docker 23.0.5 active — — —

Root Cause

The image name or tag contains uppercase letters or invalid characters, which Docker does not allow for repository names.

generic

中文

镜像名称或标签包含大写字母或无效字符，Docker 不允许仓库名称包含这些字符。

Official Documentation

https://docs.docker.com/engine/reference/commandline/tag/

Workarounds

  1. 95% success Rename the image to use only lowercase letters, numbers, and allowed symbols. Example: change 'MyApp:latest' to 'myapp:latest'. 
    Rename the image to use only lowercase letters, numbers, and allowed symbols. Example: change 'MyApp:latest' to 'myapp:latest'.
  2. 95% success If using docker-compose, ensure the image field is lowercase: 'image: myapp:1.0' instead of 'image: MyApp:1.0'. 
    If using docker-compose, ensure the image field is lowercase: 'image: myapp:1.0' instead of 'image: MyApp:1.0'.

中文步骤

  1. Rename the image to use only lowercase letters, numbers, and allowed symbols. Example: change 'MyApp:latest' to 'myapp:latest'.
  2. If using docker-compose, ensure the image field is lowercase: 'image: myapp:1.0' instead of 'image: MyApp:1.0'.

Dead Ends

Common approaches that don't work:

  1. 90% fail

    Using quotes around the image name does not fix uppercase letters; Docker still parses them as invalid.

  2. 95% fail

    Changing the tag to uppercase does not help; the repository name itself must be lowercase.