juanfont/headscale · error

no IPv4 address found for %s

Error message

no IPv4 address found for %s

What it means

Error "no IPv4 address found for %s" thrown in juanfont/headscale.

Source

Thrown at integration/tsic/tsic.go:931

	}

	return ips
}

// IPv4 returns the IPv4 address of the Tailscale instance.
func (t *TailscaleInContainer) IPv4() (netip.Addr, error) {
	ips, err := t.IPs()
	if err != nil {
		return netip.Addr{}, err
	}

	for _, ip := range ips {
		if ip.Is4() {
			return ip, nil
		}
	}

	return netip.Addr{}, fmt.Errorf("no IPv4 address found for %s", t.hostname) //nolint:err113
}

func (t *TailscaleInContainer) MustIPv4() netip.Addr {
	ip, err := t.IPv4()
	if err != nil {
		panic(err)
	}

	return ip
}

func (t *TailscaleInContainer) MustIPv6() netip.Addr {
	for _, ip := range t.MustIPs() {
		if ip.Is6() {
			return ip
		}
	}

View on GitHub (pinned to 565fd254d0)

Solutions

1. Inspect the wrapped error for the underlying cause and correct the failing condition (no IPv4 address found for); retry the operation after fixing the input, configuration, or environment.

Example fix

Inspect the wrapped error for the underlying cause and correct the failing condition (no IPv4 address found for); retry the operation after fixing the input, configuration, or environment.

When it happens

Trigger: Thrown at integration/tsic/tsic.go:931 when the library encounters an invalid state.

Common situations: The node has no IPv4 address assigned. Check that an IPv4 prefix is configured in headscale and the node received an address.

AI-assisted analysis of juanfont/headscale@565fd254d0 (2026-08-15). Data as JSON: /api/errors/e26d03053df8bf26. Report an issue: GitHub.