{"record":{"id":"48d24a58a53ae7c5","repo":"jdx/mise","slug":"mise-version-min-is-required-but-you-are-using","errorCode":null,"errorMessage":"mise version {min} is required, but you are using {cur}","messagePattern":"mise version (.+?) is required, but you are using (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/config/mod.rs","lineNumber":1339,"sourceCode":"        Ok(())\n    }\n\n    fn validate_versions(&self) -> eyre::Result<()> {\n        for cf in self.config_files.values() {\n            if let Some(spec) = cf.min_version() {\n                Self::enforce_min_version_spec(spec)?;\n            }\n        }\n        Ok(())\n    }\n\n    pub(crate) fn enforce_min_version_spec(spec: &MinVersionSpec) -> eyre::Result<()> {\n        let cur = &*version::V;\n        if let Some(required) = spec.hard_violation(cur) {\n            let min = style::eyellow(required);\n            let cur = style::eyellow(cur);\n            let msg = format!(\"mise version {min} is required, but you are using {cur}\");\n            bail!(crate::cli::self_update::append_self_update_instructions(\n                msg\n            ));\n        } else if let Some(recommended) = spec.soft_violation(cur) {\n            let min = style::eyellow(recommended);\n            let cur = style::eyellow(cur);\n            let msg = format!(\"mise version {min} is recommended, but you are using {cur}\");\n            warn!(\n                \"{}\",\n                crate::cli::self_update::append_self_update_instructions(msg)\n            );\n        }\n        Ok(())\n    }\n\n    async fn load_env(self: &Arc<Self>) -> Result<EnvResults> {\n        if Settings::no_env() || Settings::get().no_env.unwrap_or(false) {\n            return Ok(EnvResults::default());\n        }","sourceCodeStart":1321,"sourceCodeEnd":1357,"githubUrl":"https://github.com/jdx/mise/blob/533346cc374382b41ec5ff70536252b2e96e725c/src/config/mod.rs#L1321-L1357","documentation":"The current mise binary is older than the minimum version declared by a config (min_version spec hard violation). mise aborts because the config uses features requiring a newer release; the message includes self-update instructions.","triggerScenarios":"Config::enforce_min_version_spec is called with a MinVersionSpec whose hard_violation(current_version) returns Some — the running version is below the required minimum declared in mise.toml (e.g. min_version or [settings] minimum version).","commonSituations":"CI machines or colleagues running an old pinned mise against a project config that declared a newer min_version after adopting new features (monorepo support, task providers, etc.).","solutions":["Run `mise self-update` (or use the instructions appended to the error) to upgrade mise","On CI, bump the mise version in your installer action (e.g. jdx/mise-action with version or mise_version input)","If you cannot upgrade yet, temporarily remove/lower the min_version declaration — but expect newer config features to fail"],"exampleFix":"# CI before\n- uses: jdx/mise-action@v2 # old default version\n# after\n- uses: jdx/mise-action@v2\n  with:\n    version: 2026.9.0","handlingStrategy":"validation","validationCode":"# shell: compare installed mise version to required min before running\nrequired=$(grep -oP 'min_version\\s*=\\s*\"\\K[^\"]+' mise.toml)\ncur=$(mise --version | awk '{print $2}')\n[ \"$(printf '%s\\n%s\\n' \"$required\" \"$cur\" | sort -V | head -1)\" = \"$required\" ] || echo \"mise too old\"","typeGuard":null,"tryCatchPattern":"// Rust\nmatch Config::enforce_min_version_spec(&spec) {\n    Ok(()) => proceed(),\n    Err(e) if e.to_string().contains(\"is required, but you are using\") => {\n        eprintln!(\"run `mise self-update` or bump CI mise version\");\n    }\n    Err(e) => return Err(e),\n}","preventionTips":["Pin a recent mise version in CI (mise-action version input) alongside the config min_version","Run `mise self-update` regularly on dev machines","Document the required mise version in README/CONTRIBUTING when raising min_version"],"tags":["versioning","config","upgrade","cli"],"backgroundTag":"version-incompatible","analyzedSha":"533346cc374382b41ec5ff70536252b2e96e725c","analyzedAt":"2026-09-17T13:35:38.149Z","contentChangedAt":"2026-09-17T13:35:38.149Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}