hashicorp/nomad · error

invalid service registration address

Error message

invalid service registration address

What it means

ServiceRegistration.Validate rejected the registration because its address is the unspecified/any address (0.0.0.0 or ::); Nomad controls registration and a routable address is required.

Source

Thrown at nomad/structs/service_registration.go:157

	if s.Address != o.Address {
		return false
	}
	if s.Port != o.Port {
		return false
	}
	if !helper.SliceSetEq(s.Tags, o.Tags) {
		return false
	}
	return true
}

// Validate ensures the upserted service registration contains valid
// information and routing capabilities. Objects should never fail here as
// Nomad controls the entire registration process; but it's possible
// configuration problems could cause failures.
func (s *ServiceRegistration) Validate() error {
	if ipaddr.IsAny(s.Address) {
		return fmt.Errorf("invalid service registration address")
	}
	return nil
}

// GetID is a helper for getting the ID when the object may be nil and is
// required for pagination.
func (s *ServiceRegistration) GetID() string {
	if s == nil {
		return ""
	}
	return s.ID
}

// GetNamespace is a helper for getting the namespace when the object may be
// nil and is required for pagination.
func (s *ServiceRegistration) GetNamespace() string {
	if s == nil {
		return ""

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Fix the client/network configuration so the service advertises a routable IP
2. Check advertise or network interface settings producing an any-address

When it happens

Trigger: Thrown at nomad/structs/service_registration.go:157 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/e3776a6ee760ab23. Report an issue: GitHub.