Error AtlasError Documentation and Resolution
Back to search

Docker Buildx

Docker Buildx found an invalid default argument in FROM

InvalidDefaultArgInFrom

Docker Buildx build checks found a default build argument in a FROM instruction that results in an invalid image reference or unsupported default pattern.

InvalidDefaultArgInFrombuildx

Observed message

InvalidDefaultArgInFrom

Why it happens

  • The default build argument value produces an invalid image reference.
  • The Dockerfile relies on a default ARG pattern that Buildx does not accept in FROM.
  • A malformed or partial image string is assembled from build arguments.

How to fix it

  1. Review the ARG default value used in the FROM instruction.
  2. Ensure the resulting image reference is always syntactically valid.
  3. Test the build with and without overriding the argument to confirm the default is safe.

Official reference

Docker Docs: Build checks

Related errors

ReservedStageNameDocker Buildx found a reserved stage name in the DockerfileUndefinedArgInFromDocker Buildx found an undefined build argument in FROMJSONArgsRecommendedDocker Buildx recommends JSON-form command argumentsLoading the build result for multi-platform images is not supportedDocker Buildx could not load a multi-platform build result locally

Explore more

buildxBrowse more buildx errors
Docker Buildx InvalidDefaultArgInFrom: causes and fixes | Error Atlas