{"record":{"id":"dcd4385edd177ac2","repo":"jdx/mise","slug":"package-type-go-install-is-not-supported-in-the","errorCode":null,"errorMessage":"package type `go_install` is not supported in the aqua backend. Use the go backend instead: {backend}.","messagePattern":"package type `go_install` is not supported in the aqua backend\\. Use the go backend instead: (.+?)\\.","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/backend/aqua.rs","lineNumber":5031,"sourceCode":"    match pkg.package_type() {\n        AquaPackageType::Cargo => {\n            bail!(\n                \"package type `cargo` is not supported in the aqua backend. Use the cargo backend instead{}.\",\n                pkg.crate_name\n                    .as_deref()\n                    .filter(|name| !name.is_empty())\n                    .or_else(|| {\n                        pkg.name\n                            .as_deref()\n                            .and_then(|s| s.strip_prefix(\"crates.io/\"))\n                    })\n                    .map(|name| format!(\": cargo:{}\", name.escape_debug()))\n                    .unwrap_or_default()\n            )\n        }\n        AquaPackageType::GoInstall => {\n            let backend = go_install_backend(pkg, version)?;\n            bail!(\n                \"package type `go_install` is not supported in the aqua backend. Use the go backend instead: {backend}.\"\n            )\n        }\n        AquaPackageType::GoBuild => {\n            bail!(\n                \"package type `{}` is not supported in the aqua backend. Use the go backend instead{}.\",\n                pkg.package_type(),\n                pkg.path\n                    .as_ref()\n                    .map(|path| format!(\": go:{path}\"))\n                    .unwrap_or_else(|| {\n                        format!(\": go:github.com/{}/{}\", pkg.repo_owner, pkg.repo_name)\n                    })\n            )\n        }\n        _ => {}\n    }\n    Ok(())","sourceCodeStart":5013,"sourceCodeEnd":5049,"githubUrl":"https://github.com/jdx/mise/blob/afd2eddd3a50c16190efc1c7e94404b48f72af57/src/backend/aqua.rs#L5013-L5049","documentation":"mise's aqua backend only supports aqua package types it can install directly (release-archive assets, etc.). When a registry package declares `go_install` — meaning the tool should be built via `go install` — the aqua backend refuses and tells you the equivalent go-backend package string to use instead, so the build happens through mise's go backend which has the Go toolchain integration.","triggerScenarios":"Running `mise use`/`mise install` for a tool whose aqua registry entry has `type: go_install` in its package definition; the error fires in the aqua backend's install/version resolution match on AquaPackageType::GoInstall.","commonSituations":"Adding an aqua registry package that is a Go module rather than a prebuilt binary; copying an aqua.yaml package reference into mise that relied on aqua's own `go install` support.","solutions":["Use the go backend package shown in the error message, e.g. `mise use go:github.com/owner/repo` instead of the aqua: package.","Install Go first (`mise use go`) so the go backend can build the module.","If a prebuilt binary release exists for the tool, pin the aqua package to the release-asset type instead of go_install."],"exampleFix":"// before\nmise use aqua:github.com/owner/tool\n\n// after\nmise use go:github.com/owner/tool","handlingStrategy":"validation","validationCode":"type=$(mise registry ls 2>/dev/null | grep '^aqua:' )  # or inspect the aqua package type first\n# guard in config: refuse aqua: refs whose package type is go_install\n[[ \"$type\" == *go_install* ]] && echo 'use go: backend instead' && exit 1","typeGuard":null,"tryCatchPattern":"if ! mise use \"$pkg\"; then\n  echo \"aqua backend rejected package; retrying with go backend\"\n  mise use \"go:${pkg#aqua:}\"\nfi","preventionTips":["Check the aqua registry entry's package type before referencing it via aqua: in mise.","Prefer go: for Go modules and aqua: only for tools with prebuilt release assets.","Keep the go toolchain installed so go:-type installs never fail on a missing toolchain."],"tags":["aqua","go","unsupported-package-type","backend"],"backgroundTag":"unsupported-operation","analyzedSha":"afd2eddd3a50c16190efc1c7e94404b48f72af57","analyzedAt":"2026-09-09T01:38:25.179Z","contentChangedAt":"2026-09-09T01:38:25.179Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}