{"record":{"id":"3f125a818d70fe8b","repo":"hashicorp/nomad","slug":"failed-to-parse-rpc-address-q-v","errorCode":null,"errorMessage":"Failed to parse RPC address %q: %v","messagePattern":"Failed to parse RPC address %q: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"command/agent/agent.go","lineNumber":398,"sourceCode":"\t\tif jobMaxCount < 0 {\n\t\t\treturn nil, fmt.Errorf(\"job_max_count (%d) cannot be negative\", jobMaxCount)\n\t\t}\n\t}\n\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 {","sourceCodeStart":380,"sourceCodeEnd":416,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/command/agent/agent.go#L380-L416","documentation":"convertServerConfig resolves the normalized RPC bind address with net.ResolveTCPAddr; failure means the configured bind address (bad host/IP syntax or unresolvable name) cannot be used for the server's RPC listener, aborting startup.","triggerScenarios":"Thrown at command/agent/agent.go:398 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Fix the bind_addr/RPC address in the server config to a valid IP:port or resolvable host","Check DNS resolution for hostname-based bind addresses"],"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"}