hashicorp/nomad · error

fingerprint %q contains unknown configuration options: %s

Error message

fingerprint %q contains unknown configuration options: %s

What it means

Fingerprint.Validate fires when ExtraKeysHCL is populated — the user supplied unknown/extra configuration keys to a fingerprinter that does not accept them — and the message lists the offending keys via strings.Join.

Source

Thrown at client/config/fingerprint.go:115

	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 unrecognized keys from the fingerprint block
2. Check the fingerprinter's documented options

When it happens

Trigger: Thrown at client/config/fingerprint.go:115 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/33436b5bc0b7c5d7. Report an issue: GitHub.