hashicorp/nomad · error

fingerprint %q does not support configuration

Error message

fingerprint %q does not support configuration

What it means

Fingerprint.Validate rejects a fingerprint block whose Name is not one of the fingerprinters that support per-block configuration (validEnvFingerprinters); the user supplied a config block for a fingerprinter that cannot accept one.

Source

Thrown at client/config/fingerprint.go:106

		result.ExitOnFailure = z.ExitOnFailure
	}

	return &result
}

// Validate the fingerprint block to ensure we do not have any values that
// cannot be handled.
func (f *Fingerprint) Validate() error {

	if f == nil {
		return nil
	}

	if f.Name == "" {
		return errors.New("fingerprint name cannot be empty")
	}
	if !slices.Contains(validEnvFingerprinters, f.Name) {
		return fmt.Errorf("fingerprint %q does not support configuration", f.Name)
	}
	if f.RetryInterval < 0 {
		return fmt.Errorf("fingerprint %q retry interval cannot be negative", f.Name)
	}
	if f.RetryAttempts < -1 {
		return fmt.Errorf("fingerprint %q retry attempts cannot be less than -1", f.Name)
	}
	if len(f.ExtraKeysHCL) > 0 {
		return fmt.Errorf("fingerprint %q contains unknown configuration options: %s",
			f.Name, strings.Join(f.ExtraKeysHCL, ","))
	}

	return nil
}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Remove the config block or use a supported fingerprinter name
2. Check validEnvFingerprinters for the allowlist of configurable fingerprinters

When it happens

Trigger: Thrown at client/config/fingerprint.go:106 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/4861dbc425cdc756. Report an issue: GitHub.