{"id":"ceeb139e9e79af84","repo":"docker/cli","slug":"volume-s-volume-external-name-and-volume-name-co","errorCode":null,"errorMessage":"volume %s: volume.external.name and volume.name conflict; only use volume.name","messagePattern":"volume (.+?): volume\\.external\\.name and volume\\.name conflict; only use volume\\.name","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cli/compose/loader/loader.go","lineNumber":595,"sourceCode":"\tvolumes := make(map[string]types.VolumeConfig)\n\tif err := Transform(source, &volumes); err != nil {\n\t\treturn volumes, err\n\t}\n\n\tfor name, volume := range volumes {\n\t\tif !volume.External.External {\n\t\t\tcontinue\n\t\t}\n\t\tswitch {\n\t\tcase volume.Driver != \"\":\n\t\t\treturn nil, externalVolumeError(name, \"driver\")\n\t\tcase len(volume.DriverOpts) > 0:\n\t\t\treturn nil, externalVolumeError(name, \"driver_opts\")\n\t\tcase len(volume.Labels) > 0:\n\t\t\treturn nil, externalVolumeError(name, \"labels\")\n\t\tcase volume.External.Name != \"\":\n\t\t\tif volume.Name != \"\" {\n\t\t\t\treturn nil, fmt.Errorf(\"volume %s: volume.external.name and volume.name conflict; only use volume.name\", name)\n\t\t\t}\n\t\t\tif versions.GreaterThanOrEqualTo(version, \"3.4\") {\n\t\t\t\tlogrus.Warnf(\"volume %s: volume.external.name is deprecated in favor of volume.name\", name)\n\t\t\t}\n\t\t\tvolume.Name = volume.External.Name\n\t\t\tvolume.External.Name = \"\"\n\t\tcase volume.Name == \"\":\n\t\t\tvolume.Name = name\n\t\t}\n\t\tvolume.Extras = loadExtras(name, source)\n\t\tvolumes[name] = volume\n\t}\n\treturn volumes, nil\n}\n\n// LoadSecrets produces a SecretConfig map from a compose file Dict\n// the source Dict is not validated if directly used. Use Load() to enable validation\nfunc LoadSecrets(source map[string]any, details types.ConfigDetails) (map[string]types.SecretConfig, error) {","sourceCodeStart":577,"sourceCodeEnd":613,"githubUrl":"https://github.com/docker/cli/blob/e9452d6e785f6e365712b9d71bd7517591773c86/cli/compose/loader/loader.go#L577-L613","documentation":"Error \"volume %s: volume.external.name and volume.name conflict; only use volume.name\" thrown in docker/cli.","triggerScenarios":"Thrown at cli/compose/loader/loader.go:595 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"e9452d6e785f6e365712b9d71bd7517591773c86","analyzedAt":"2026-08-01T07:09:22.474Z","schemaVersion":2}