docker/cli · error

invalid field %s

Error message

invalid field %s

What it means

Error "invalid field %s" thrown in docker/cli.

Source

Thrown at opts/network.go:62

	longSyntax, err := regexp.MatchString(`\w+=\w+(,\w+=\w+)*`, value)
	if err != nil {
		return err
	}

	var netOpt NetworkAttachmentOpts
	if longSyntax {
		csvReader := csv.NewReader(strings.NewReader(value))
		fields, err := csvReader.Read()
		if err != nil {
			return err
		}

		netOpt.Aliases = []string{}
		for _, field := range fields {
			// TODO(thaJeztah): these options should not be case-insensitive.
			key, val, ok := strings.Cut(strings.ToLower(field), "=")
			if !ok || key == "" {
				return fmt.Errorf("invalid field %s", field)
			}

			key = strings.TrimSpace(key)
			val = strings.TrimSpace(val)

			switch key {
			case networkOptName:
				netOpt.Target = val
			case networkOptAlias:
				netOpt.Aliases = append(netOpt.Aliases, val)
			case networkOptIPv4Address:
				netOpt.IPv4Address, err = netip.ParseAddr(val)
				if err != nil {
					return err
				}
			case networkOptIPv6Address:
				netOpt.IPv6Address, err = netip.ParseAddr(val)
				if err != nil {

View on GitHub (pinned to e9452d6e78)

When it happens

Trigger: Thrown at opts/network.go:62 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/635f125535dd465e.json. Report an issue: GitHub.