docker/cli · error

path %q lacks required file extension (.exe)

Error message

path %q lacks required file extension (.exe)

What it means

Error "path %q lacks required file extension (.exe)" thrown in docker/cli.

Source

Thrown at cli-plugins/manager/suffix_windows.go:13

package manager

import (
	"fmt"
	"path/filepath"
	"strings"
)

// This is made slightly more complex due to needing to be case-insensitive.
func trimExeSuffix(s string) (string, error) {
	ext := filepath.Ext(s)
	if ext == "" || !strings.EqualFold(ext, ".exe") {
		return "", fmt.Errorf("path %q lacks required file extension (.exe)", s)
	}
	return strings.TrimSuffix(s, ext), nil
}

func addExeSuffix(s string) string {
	return s + ".exe"
}

View on GitHub (pinned to e9452d6e78)

When it happens

Trigger: Thrown at cli-plugins/manager/suffix_windows.go:13 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/6b8c862c3bb685be.json. Report an issue: GitHub.