{"record":{"id":"e55a4a8a30d6a9d7","repo":"hashicorp/nomad","slug":"failed-to-parse-serf-address-q-v","errorCode":null,"errorMessage":"Failed to parse Serf address %q: %v","messagePattern":"Failed to parse Serf address %q: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"command/agent/agent.go","lineNumber":402,"sourceCode":"\tconf.JobMaxCount = jobMaxCount\n\n\tif agentConfig.Server.JobTrackedVersions != nil {\n\t\tif *agentConfig.Server.JobTrackedVersions <= 0 {\n\t\t\treturn nil, fmt.Errorf(\"job_tracked_versions must be greater than 0\")\n\t\t}\n\t\tconf.JobTrackedVersions = *agentConfig.Server.JobTrackedVersions\n\t}\n\n\tconf.OIDCIssuer = agentConfig.Server.OIDCIssuer\n\n\t// Set up the bind addresses\n\trpcAddr, err := net.ResolveTCPAddr(\"tcp\", agentConfig.normalizedAddrs.RPC)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"Failed to parse RPC address %q: %v\", agentConfig.normalizedAddrs.RPC, err)\n\t}\n\tserfAddr, err := net.ResolveTCPAddr(\"tcp\", agentConfig.normalizedAddrs.Serf)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"Failed to parse Serf address %q: %v\", agentConfig.normalizedAddrs.Serf, err)\n\t}\n\tconf.RPCAddr.Port = rpcAddr.Port\n\tconf.RPCAddr.IP = rpcAddr.IP\n\tconf.SerfConfig.MemberlistConfig.BindPort = serfAddr.Port\n\tconf.SerfConfig.MemberlistConfig.BindAddr = serfAddr.IP.String()\n\tconf.SerfConfig.RejoinAfterLeave = agentConfig.Server.RejoinAfterLeave\n\n\t// Set up the advertise addresses\n\trpcAddr, err = net.ResolveTCPAddr(\"tcp\", agentConfig.AdvertiseAddrs.RPC)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"Failed to parse RPC advertise address %q: %v\", agentConfig.AdvertiseAddrs.RPC, err)\n\t}\n\tserfAddr, err = net.ResolveTCPAddr(\"tcp\", agentConfig.AdvertiseAddrs.Serf)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"Failed to parse Serf advertise address %q: %v\", agentConfig.AdvertiseAddrs.Serf, err)\n\t}\n\n\t// Server address is the serf advertise address and rpc port. This is the","sourceCodeStart":384,"sourceCodeEnd":420,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/command/agent/agent.go#L384-L420","documentation":"Same resolution failure as RPC but for the Serf (gossip) bind address: net.ResolveTCPAddr cannot parse/resolve the configured Serf address, so the memberlist configuration cannot be built and server startup aborts.","triggerScenarios":"Thrown at command/agent/agent.go:402 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Correct the Serf bind address in the server config","Use a valid IP or resolvable hostname with a port"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"482b49bf1aec006f089bcfc7e632d8f6ac303e5e","analyzedAt":"2026-09-04T07:54:14.808Z","contentChangedAt":"2026-09-04T07:54:14.808Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}