Dotnet backend

The code for this is inside the mise repository at ./src/backend/dotnet.rs.

Important

The dotnet backend requires having the .NET runtime installed. You can install it using mise:

# Install the latest version
mise use dotnet

# Or install a specific version (8, 9, etc.)
mise use dotnet@8
mise use dotnet@9

This will install the .NET runtime, which is required for dotnet tools to work properly.

Usage

The following installs the latest version of GitVersion.Tool and sets it as the active version on PATH:

$ mise use dotnet:GitVersion.Tool@5.12.0
$ dotnet-gitversion /version
5.12.0+Branch.support-5.x.Sha.3f75764963eb3d7956dcd5a40488c074dd9faf9e

The version will be set in ~/.config/mise/config.toml with the following format:

[tools]
"dotnet:GitVersion.Tool" = "5.12.0"

$ mise use dotnet:GitVersion.Tool
$ dotnet-gitversion /version
6.1.0+Branch.main.Sha.8856e3041dbb768118a55a31ad4e465ae70c6767

The version will be set in ~/.config/mise/config.toml with the following format:

[tools]
"dotnet:GitVersion.Tool" = "latest"

Supported Dotnet Syntax

Description	Usage
Dotnet shorthand latest version	dotnet:GitVersion.Tool
Dotnet shorthand for specific version	dotnet:GitVersion.Tool@5.12.0

Settings

Set these with mise settings set [VARIABLE] [VALUE] or by setting the environment variable listed.

dotnet.package_flags

• Type: string[]
• Env: MISE_DOTNET_PACKAGE_FLAGS(comma separated)
• Default: []

This is a list of flags to extend the search and install abilities of dotnet tools.

Here are the available flags:

• 'prerelease' : include prerelease versions in search and install

dotnet.registry_url

• Type: Url
• Env: MISE_DOTNET_REGISTRY_URL
• Default: https://api.nuget.org/v3/index.json

URL to fetch dotnet tools from. This is used when installing dotnet tools.

By default, mise will use the nuget API to fetch.

However, you can set this to a different URL if you have a custom feed or want to use a different source.

Tool Options

The following tool-options are available for the dotnet backend—these go in [tools] in mise.toml.