hashicorp/nomad · error

failed to configure network: no interface with an address

Error message

failed to configure network: no interface with an address

What it means

Returned by cniToAllocNet when the parsed CNI result contains no interface with an IPv4 or IPv6 address (including the fallback to the first addressed interface). Without any address the allocation's network status cannot be populated.

Source

Thrown at client/allocrunner/networking_cni.go:504

		}
	}

	// Use the first sandbox interface with an IP address
	setStatus(true)

	// If no IP address was found, use the first interface with an address
	// found as a fallback
	if netStatus.Address == "" && netStatus.AddressIPv6 == "" {
		setStatus(false)
		c.logger.Debug("no sandbox interface with an address found CNI result, using first available",
			"interface", netStatus.InterfaceName,
			"ip", netStatus.Address,
		)
	}

	// If no IP address (IPv4 or IPv6) could be found, return an error
	if netStatus.Address == "" && netStatus.AddressIPv6 == "" {
		return nil, fmt.Errorf("failed to configure network: no interface with an address")

	}

	// Fallback: if no IPv4 address but we have IPv6, copy it to Address field
	// for backward compatibility with code that only checks Address field
	// (e.g. service registration with address_mode="alloc")
	if netStatus.Address == "" && netStatus.AddressIPv6 != "" {
		netStatus.Address = netStatus.AddressIPv6
	}

	// Use the first DNS results, if non-empty
	if len(res.DNS) > 0 {
		cniDNS := res.DNS[0]
		if len(cniDNS.Nameservers) > 0 {
			netStatus.DNS = &structs.DNSConfig{
				Servers:  cniDNS.Nameservers,
				Searches: cniDNS.Search,
				Options:  cniDNS.Options,

View on GitHub (pinned to 482b49bf1a)

Solutions

  1. Check IPAM subnet capacity - exhaustion yields interfaces without addresses
  2. Inspect CNI plugin logs and the nomad bridge state
  3. Verify IP range config in the CNI conf and that no addresses were leaked
  4. Clean stale bridges/IPAM store and retry
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at client/allocrunner/networking_cni.go:504 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/15625d720b057f1d. Report an issue: GitHub.