hashicorp/nomad · error

All servers should be running version %v to update autopilot

Error message

All servers should be running version %v to update autopilot config

What it means

AutopilotSetConfiguration was rejected because not all servers in the region meet the minimum Nomad version required for autopilot config updates (0.8.0+); the cluster is running mixed versions.

Source

Thrown at nomad/operator_endpoint.go:363

	if done, err := op.srv.forward("Operator.AutopilotSetConfiguration", args, args, reply); done {
		return err
	}
	op.srv.MeasureRPCRate("operator", structs.RateMetricWrite, args)
	if authErr != nil {
		return structs.ErrPermissionDenied
	}

	// This action requires operator write access.
	aclObj, err := op.srv.ResolveACL(args)
	if err != nil {
		return err
	} else if !aclObj.AllowOperatorWrite() {
		return structs.ErrPermissionDenied
	}

	// All servers should be at or above 0.8.0 to apply this operation
	if !op.srv.peersCache.ServersMeetMinimumVersion(op.srv.Region(), minAutopilotVersion, false) {
		return fmt.Errorf("All servers should be running version %v to update autopilot config", minAutopilotVersion)
	}

	// Apply the update
	resp, _, err := op.srv.raftApply(structs.AutopilotRequestType, args)
	if err != nil {
		op.logger.Error("failed applying AutoPilot configuration", "error", err)
		return err
	}

	// Check if the return type is a bool.
	if respBool, ok := resp.(bool); ok {
		*reply = respBool
	}
	return nil
}

// ServerHealth is used to get the current health of the servers.
func (op *Operator) ServerHealth(args *structs.GenericRequest, reply *structs.OperatorHealthReply) error {

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Upgrade all servers in the region to at least the minimum required version
2. Finish any in-progress rolling upgrade and retry once the peers cache reflects the new versions
3. Check `nomad server members` for outdated servers

When it happens

Trigger: Thrown at nomad/operator_endpoint.go:363 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/da0efefb8e44b5f7. Report an issue: GitHub.