docker/cli · error

no matching subnet for aux-address %s

Error message

no matching subnet for aux-address %s

What it means

Error "no matching subnet for aux-address %s" thrown in docker/cli.

Source

Thrown at cli/command/network/create.go:238

		}
		auxAddr, err := netip.ParseAddr(aa)
		if err != nil {
			return nil, err
		}
		match := false
		for _, s := range options.subnets {
			ok, err := subnetMatches(s, auxAddr.String())
			if err != nil {
				return nil, err
			}
			if !ok {
				continue
			}
			iData[s].AuxAddress[name] = auxAddr
			match = true
		}
		if !match {
			return nil, fmt.Errorf("no matching subnet for aux-address %s", aa)
		}
	}

	idl := make([]network.IPAMConfig, 0, len(iData))
	for _, v := range iData {
		idl = append(idl, *v)
	}

	return &network.IPAM{
		Driver:  options.driver,
		Config:  idl,
		Options: options.driverOpts.GetAll(),
	}, nil
}

func subnetMatches(subnet, data string) (bool, error) {
	var ip net.IP

View on GitHub (pinned to e9452d6e78)

When it happens

Trigger: Thrown at cli/command/network/create.go:238 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of docker/cli@e9452d6e78 (2026-08-01). Data as JSON: /data/errors/a0e2a8a94d14efd5.json. Report an issue: GitHub.