{"id":"f8234fb5c1750a43","repo":"docker/cli","slug":"plugin-schemaversion-q-is-not-supported-must-be","errorCode":null,"errorMessage":"plugin SchemaVersion %q is not supported: must be lower than 2.0.0","messagePattern":"plugin SchemaVersion %q is not supported: must be lower than 2\\.0\\.0","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cli-plugins/manager/plugin.go","lineNumber":151,"sourceCode":"// The current schema-version is \"0.1.0\", but we don't want to break compatibility\n// until v2.0.0 of the schema version. Check for the major version to be < 2.0.0.\n//\n// Note that CLI versions before 28.4.1 may not support these versions as they were\n// hard-coded to only accept \"0.1.0\".\nfunc validateSchemaVersion(version string) error {\n\tif version == \"0.1.0\" {\n\t\treturn nil\n\t}\n\tif version == \"\" {\n\t\treturn errors.New(\"plugin SchemaVersion version cannot be empty\")\n\t}\n\tmajor, _, ok := strings.Cut(version, \".\")\n\tmajorVersion, err := strconv.Atoi(major)\n\tif !ok || err != nil {\n\t\treturn fmt.Errorf(\"plugin SchemaVersion %q has wrong format: must be <major>.<minor>.<patch>\", version)\n\t}\n\tif majorVersion > 1 {\n\t\treturn fmt.Errorf(\"plugin SchemaVersion %q is not supported: must be lower than 2.0.0\", version)\n\t}\n\treturn nil\n}\n\n// RunHook executes the plugin's hooks command\n// and returns its unprocessed output.\nfunc (p *Plugin) RunHook(ctx context.Context, hookData hooks.Request) ([]byte, error) {\n\thDataBytes, err := json.Marshal(hookData)\n\tif err != nil {\n\t\treturn nil, wrapAsPluginError(err, \"failed to marshall hook data\")\n\t}\n\n\tpCmd := exec.CommandContext(ctx, p.Path, p.Name, metadata.HookSubcommandName, string(hDataBytes)) // #nosec G204 -- ignore \"Subprocess launched with a potential tainted input or cmd arguments\"\n\tpCmd.Env = os.Environ()\n\tpCmd.Env = append(pCmd.Env, metadata.ReexecEnvvar+\"=\"+os.Args[0])\n\n\tout, err := pCmd.Output()\n\tif err != nil {","sourceCodeStart":133,"sourceCodeEnd":169,"githubUrl":"https://github.com/docker/cli/blob/e9452d6e785f6e365712b9d71bd7517591773c86/cli-plugins/manager/plugin.go#L133-L169","documentation":"Error \"plugin SchemaVersion %q is not supported: must be lower than 2.0.0\" thrown in docker/cli.","triggerScenarios":"Thrown at cli-plugins/manager/plugin.go:151 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"e9452d6e785f6e365712b9d71bd7517591773c86","analyzedAt":"2026-08-01T07:09:22.474Z","schemaVersion":2}