Skip to content

Automated Dependency Updates for mise

Categories: no-category

Renovate supports updating mise dependencies.

File Matching

By default, Renovate will check any files matching any of the following regular expressions:

(^|/)\.?mise\.toml$
(^|/)\.?mise/config\.toml$

For details on how to extend a manager's fileMatch value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: dart-version, docker, dotnet-version, flutter-version, github-releases, github-tags, hexpm-bob, java-version, node-version, npm, pypi, ruby-version.

Default config

{
  "fileMatch": [
    "(^|/)\\.?mise\\.toml$",
    "(^|/)\\.?mise/config\\.toml$"
  ]
}

Additional Information

Renovate can update the mise .mise.toml file.

Renovate's mise manager can version these tools:

Renovate only updates primary versions

Renovate's mise manager is designed to automatically update the first (primary) version listed for each tool in the .mise.toml file.

Secondary or fallback versions require manual updates.

Example

Given a .mise.toml entry like:

[tools]
erlang = ["23.3", "22.0"]

Renovate will update "23.3" (the primary version) but will not touch "22.0" (the fallback version).

Why can Renovate only update primary versions?

To maintain consistency and reliability, Renovate opts to only manage the first listed version.

  • Fallback versions can often be older versions of a tool that are known to work and are there as a backup.

This follows the same workflow that Renovate's asdf manager uses.

Plugin/tool support

Renovate uses:

to understand and manage tool versioning.

Support for new tools/plugins needs to be manually added to Renovate's logic.

Adding new tool support

There are 2 ways to integrate versioning for a new tool:

  • Renovate's mise manager: ensure upstream mise supports the tool, then add support to the mise manager in Renovate
  • Renovate's asdf manager: improve the asdf manager in Renovate, which automatically extends support to mise

If mise adds support for more tools via its own core plugins, you can create a PR to extend Renovate's mise manager to add support for the new tooling.

You may be able to add support for new tooling upstream in the core plugins - create an issue and see if the community agrees whether it belongs there, or if it would be better as an asdf- plugin.

If you are wanting to add support for an existing asdf-x plugin to mise, you can create a PR to extend Renovate's asdf manager, which indirectly helps Renovate's mise manager as well.

Open items

The below list of features were current when this page was generated on November 21, 2024.

Feature requests

  • [manager/mise]: add support for additional backends #30387
  • mise manager: keep prefix: version constraints when updating #30365