{"record":{"id":"76a9e6cdb27de29d","repo":"docker/compose","slug":"interface-name-requires-docker-engine-s-or-later","errorCode":null,"errorMessage":"interface_name requires Docker Engine %s or later","messagePattern":"interface_name requires Docker Engine (.+?) or later","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/compose/create.go","lineNumber":609,"sourceCode":"\n// defaultNetworkSettings determines the container.NetworkMode and corresponding network.NetworkingConfig (nil if not applicable).\nfunc defaultNetworkSettings(project *types.Project,\n\tservice types.ServiceConfig, serviceIndex int,\n\tlinks []string, useNetworkAliases bool,\n\tversion string,\n) (container.NetworkMode, *network.NetworkingConfig, error) {\n\tif service.NetworkMode != \"\" {\n\t\treturn container.NetworkMode(service.NetworkMode), nil, nil\n\t}\n\n\tif len(project.Networks) == 0 {\n\t\treturn network.NetworkNone, nil, nil\n\t}\n\n\tif versions.LessThan(version, apiVersion149) {\n\t\tfor _, config := range service.Networks {\n\t\t\tif config != nil && config.InterfaceName != \"\" {\n\t\t\t\treturn \"\", nil, fmt.Errorf(\"interface_name requires Docker Engine %s or later\", DockerEngineV28_1)\n\t\t\t}\n\t\t}\n\t}\n\n\tserviceNetworks := service.NetworksByPriority()\n\tprimaryNetworkKey := \"default\"\n\tif len(serviceNetworks) > 0 {\n\t\tprimaryNetworkKey = serviceNetworks[0]\n\t\tserviceNetworks = serviceNetworks[1:]\n\t}\n\n\tprimaryNetworkEndpoint, err := createEndpointSettings(project, service, serviceIndex, primaryNetworkKey, links, useNetworkAliases)\n\tif err != nil {\n\t\treturn \"\", nil, err\n\t}\n\tif primaryNetworkEndpoint.MacAddress.String() == \"\" {\n\t\tprimaryNetworkEndpoint.MacAddress, err = parseMACAddr(service.MacAddress)\n\t\tif err != nil {","sourceCodeStart":591,"sourceCodeEnd":627,"githubUrl":"https://github.com/docker/compose/blob/ddc4b044b62e9f715212ea4143fa830fac76382f/pkg/compose/create.go#L591-L627","documentation":"Error \"interface_name requires Docker Engine %s or later\" thrown in docker/compose.","triggerScenarios":"A network configuration uses 'interface_name', which requires a Docker Engine version newer than the one currently connected.","commonSituations":"The Docker daemon is older than the minimum version supporting interface_name; upgrade the engine or remove the option.","solutions":["Upgrade the Docker Engine to the required version or later to use interface_name.","Remove the interface_name field from the network configuration if upgrading is not possible."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"ddc4b044b62e9f715212ea4143fa830fac76382f","analyzedAt":"2026-08-15T13:31:42.319Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}