{"record":{"id":"cb4fa4814aa55a61","repo":"hashicorp/terraform","slug":"plugin-is-not-supported-by-your-computer-architect","errorCode":null,"errorMessage":"plugin is not supported by your computer architecture/operating system","messagePattern":"plugin is not supported by your computer architecture/operating system","errorType":"exception","errorClass":"ErrArchNotSupported","httpStatus":null,"severity":"error","filePath":"internal/pluginshared/errors.go","lineNumber":21,"sourceCode":"\npackage pluginshared\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n)\n\nvar (\n\t// ErrPluginNotSupported is the error returned when the upstream HCP Terraform does not\n\t// have a manifest.\n\tErrPluginNotSupported = errors.New(\"plugin is not supported by the remote version of Terraform Enterprise\")\n\n\t// ErrRequestCanceled is the error returned when the context was cancelled.\n\tErrRequestCanceled = errors.New(\"request was canceled\")\n\n\t// ErrArchNotSupported is the error returned when the plugin does not have a build for the\n\t// current OS/Architecture.\n\tErrArchNotSupported = errors.New(\"plugin is not supported by your computer architecture/operating system\")\n\n\t// ErrPluginNotFound is the error returned when the plugin manifest points to a location\n\t// that was does not exist.\n\tErrPluginNotFound = errors.New(\"plugin download was not found in the location specified in the manifest\")\n)\n\n// ErrQueryFailed is the error returned when the plugin http client request fails\ntype ErrQueryFailed struct {\n\tinner error\n}\n\n// ErrCloudPluginNotVerified is the error returned when the archive authentication process fails\ntype ErrCloudPluginNotVerified struct {\n\tinner error\n}\n\n// Error returns a string representation of ErrQueryFailed\nfunc (e ErrQueryFailed) Error() string {","sourceCodeStart":3,"sourceCodeEnd":39,"githubUrl":"https://github.com/hashicorp/terraform/blob/d32a084675427f5ac3f7d2868578ef8b2c1dc525/internal/pluginshared/errors.go#L3-L39","documentation":"ErrArchNotSupported is returned by Release.Select when the downloaded manifest contains no build matching the runtime's GOOS/GOARCH pair. The plugin publisher did not ship a binary for the current operating system / architecture combination.","triggerScenarios":"Release.Select iterates m.Builds comparing each build's \"<goos>_<arch>\" against the requested pair; if none matches it returns ErrArchNotSupported along with the list of supported combinations.","commonSituations":"Running Terraform on an uncommon platform (e.g. linux/arm64 when only linux/amd64 was published, or darwin/arm64 on an older release); the plugin maintainer did not cross-compile for the user's platform; running on a brand-new Go port (e.g. linux/riscv64).","solutions":["Run Terraform on one of the supported OS/arch combinations reported by Select's error/list.","Upgrade (or downgrade) the plugin to a release that ships a binary for your platform.","Build the plugin from source for your GOOS/GOARCH and install it locally, bypassing the manifest lookup.","File an issue with the plugin maintainer requesting a build for your platform."],"exampleFix":"n/a — runtime environment mismatch; resolved by switching platform or plugin version, not by code.","handlingStrategy":"validation","validationCode":"// Check supported platforms before attempting Select\ngoos := runtime.GOOS\narch := runtime.GOARCH\n// consult Release.Builds for \"<goos>_<arch>\" entries first","typeGuard":"n/a — runtime/platform predicate, not a type guard.","tryCatchPattern":"build, err := manifest.Select(pluginName, runtime.GOOS, runtime.GOARCH)\nif errors.Is(err, pluginshared.ErrArchNotSupported) {\n    // enumerate supported combos from manifest.Builds and surface them\n    return supportedArchsError(manifest)\n}","preventionTips":["Run on a platform the plugin publishes (check the release assets).","When distributing internal plugins, cross-compile for all target GOOS/GOARCH pairs.","Fail fast at startup with a clear 'no build for <os>/<arch>' message."],"tags":["architecture","platform","plugin-download","terraform"],"backgroundTag":null,"analyzedSha":"d32a084675427f5ac3f7d2868578ef8b2c1dc525","analyzedAt":"2026-08-11T18:43:52.779Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}