hashicorp/nomad · error

ExecTask is not supported by this driver

Error message

ExecTask is not supported by this driver

What it means

DriverExecTaskNotSupported.ExecTask: the embedded no-op implementation returns this sentinel because the task driver does not support executing commands inside task containers (e.g. docker exec-style operations).

Source

Thrown at plugins/drivers/driver.go:132

	DestroyNetwork(allocID string, spec *NetworkIsolationSpec) error
}

// DriverSignalTaskNotSupported can be embedded by drivers which don't support
// the SignalTask RPC. This satisfies the SignalTask func requirement for the
// DriverPlugin interface.
type DriverSignalTaskNotSupported struct{}

func (DriverSignalTaskNotSupported) SignalTask(taskID, signal string) error {
	return fmt.Errorf("SignalTask is not supported by this driver")
}

// DriverExecTaskNotSupported can be embedded by drivers which don't support
// the ExecTask RPC. This satisfies the ExecTask func requirement of the
// DriverPlugin interface.
type DriverExecTaskNotSupported struct{}

func (_ DriverExecTaskNotSupported) ExecTask(taskID string, cmd []string, timeout time.Duration) (*ExecTaskResult, error) {
	return nil, fmt.Errorf("ExecTask is not supported by this driver")
}

type HealthState string

var (
	HealthStateUndetected = HealthState("undetected")
	HealthStateUnhealthy  = HealthState("unhealthy")
	HealthStateHealthy    = HealthState("healthy")
)

type Fingerprint struct {
	Attributes        map[string]*pstructs.Attribute
	Health            HealthState
	HealthDescription string

	// Err is set by the plugin if an error occurred during fingerprinting
	Err error
}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Run the workload under a driver that supports exec (exec, docker)
2. Interact with the task through its logs or a sidecar instead

When it happens

Trigger: Thrown at plugins/drivers/driver.go:132 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/0de16d4a736a6687. Report an issue: GitHub.