{"record":{"id":"4d104ac1c87fb706","repo":"hashicorp/nomad","slug":"failed-to-parse-serf-advertise-address-q-v","errorCode":null,"errorMessage":"Failed to parse Serf advertise address %q: %v","messagePattern":"Failed to parse Serf advertise address %q: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"command/agent/agent.go","lineNumber":417,"sourceCode":"\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\n\t// address that all servers should be able to communicate over RPC with.\n\tserverAddr, err := net.ResolveTCPAddr(\"tcp\", net.JoinHostPort(serfAddr.IP.String(), fmt.Sprintf(\"%d\", rpcAddr.Port)))\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"Failed to resolve Serf advertise address %q: %v\", agentConfig.AdvertiseAddrs.Serf, err)\n\t}\n\n\tconf.SerfConfig.MemberlistConfig.AdvertiseAddr = serfAddr.IP.String()\n\tconf.SerfConfig.MemberlistConfig.AdvertisePort = serfAddr.Port\n\tconf.ClientRPCAdvertise = rpcAddr\n\tconf.ServerRPCAdvertise = serverAddr\n\n\t// Set up gc threshold and heartbeat grace period\n\tif gcThreshold := agentConfig.Server.NodeGCThreshold; gcThreshold != \"\" {\n\t\tdur, err := time.ParseDuration(gcThreshold)\n\t\tif err != nil {","sourceCodeStart":399,"sourceCodeEnd":435,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/command/agent/agent.go#L399-L435","documentation":"Fires in convertServerConfig when net.ResolveTCPAddr cannot parse the configured Serf advertise address (malformed host:port or unresolvable hostname), so the gossip advertise address is unusable.","triggerScenarios":"Thrown at command/agent/agent.go:417 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Fix advertise { serf } to a valid resolvable address","Omit to default to the bind address"],"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"}