{"record":{"id":"4988a1f861c4894c","repo":"docker/compose","slug":"invalid-link-local-ip-w","errorCode":null,"errorMessage":"invalid link-local IP: %w","messagePattern":"invalid link-local IP: %w","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/compose/create.go","lineNumber":510,"sourceCode":"\t\t\tipv4Address, err = netip.ParseAddr(config.Ipv4Address)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, fmt.Errorf(\"invalid IPv4 address: %w\", err)\n\t\t\t}\n\t\t}\n\t\tif config.Ipv6Address != \"\" {\n\t\t\tipv6Address, err = netip.ParseAddr(config.Ipv6Address)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, fmt.Errorf(\"invalid IPv6 address: %w\", err)\n\t\t\t}\n\t\t}\n\t\tvar linkLocalIPs []netip.Addr\n\t\tfor _, link := range config.LinkLocalIPs {\n\t\t\tif link == \"\" {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tllIP, err := netip.ParseAddr(link)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, fmt.Errorf(\"invalid link-local IP: %w\", err)\n\t\t\t}\n\t\t\tlinkLocalIPs = append(linkLocalIPs, llIP)\n\t\t}\n\n\t\tipam = &network.EndpointIPAMConfig{\n\t\t\tIPv4Address:  ipv4Address.Unmap(),\n\t\t\tIPv6Address:  ipv6Address,\n\t\t\tLinkLocalIPs: linkLocalIPs,\n\t\t}\n\t\tmacAddress = config.MacAddress\n\t\tdriverOpts = config.DriverOpts\n\t\tif config.InterfaceName != \"\" {\n\t\t\tif driverOpts == nil {\n\t\t\t\tdriverOpts = map[string]string{}\n\t\t\t}\n\t\t\tif name, ok := driverOpts[ifname]; ok && name != config.InterfaceName {\n\t\t\t\tlogrus.Warnf(\"ignoring services.%s.networks.%s.interface_name as %s driver_opts is already declared\", service.Name, networkKey, ifname)\n\t\t\t}","sourceCodeStart":492,"sourceCodeEnd":528,"githubUrl":"https://github.com/docker/compose/blob/ddc4b044b62e9f715212ea4143fa830fac76382f/pkg/compose/create.go#L492-L528","documentation":"Error \"invalid link-local IP: %w\" thrown in docker/compose.","triggerScenarios":"A link-local IP entry in the service's network configuration cannot be parsed as a valid IP address.","commonSituations":"Typo in a link_local_ip value, a hostname instead of an IP, or a value outside the 169.254.0.0/16 (or fe80::/10) range.","solutions":["Correct each entry in link_local_ips to a valid address in the 169.254.0.0/16 (or fe80::/10) range.","Remove the invalid link_local_ips entries."],"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"}