Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

programs.mise.enable

Whether to enable mise.

Type: boolean

Default:

false

Example:

true

Declared by:

programs.mise.enableBashIntegration

Whether to enable Bash integration.

Type: boolean

Default:

Example:

false

Declared by:

programs.mise.enableFishIntegration

Whether to enable Fish integration.

Type: boolean

Default:

Example:

false

Declared by:

programs.mise.enableMutableConfig

Whether to leave $XDG_CONFIG_HOME/mise/config.toml mutable so it can be updated by commands such as mise use --global.

When enabled, programs.mise.globalConfig is written to $XDG_CONFIG_HOME/mise/conf.d/50-home-manager.toml instead, leaving the main configuration file unmanaged. The numeric prefix gives user-managed fragments predictable ordering around the Home Manager fragment. An empty mutable configuration file is created because global Mise commands otherwise try to update an existing global fragment, including the read-only Home Manager fragment.

Keep settings in the mutable file and programs.mise.globalConfig disjoint. Mise may resolve conflicts between the global file and conf.d differently depending on the current directory.

Before disabling this option while programs.mise.globalConfig is non-empty, remove or back up the mutable configuration file. Home Manager otherwise treats it as a file collision.

Type: boolean

Default:

false

Example:

true

Declared by:

programs.mise.enableNushellIntegration

Whether to enable Nushell integration.

Type: boolean

Default:

Example:

false

Declared by:

programs.mise.enableZshIntegration

Whether to enable Zsh integration.

Type: boolean

Default:

Example:

false

Declared by:

programs.mise.package

The mise package to use.

Type: null or package

Default:

pkgs.mise

Declared by:

programs.mise.globalConfig

Global configuration written to $XDG_CONFIG_HOME/mise/config.toml, or $XDG_CONFIG_HOME/mise/conf.d/50-home-manager.toml when programs.mise.enableMutableConfig is enabled.

See https://mise.jdx.dev/configuration.html and https://mise.jdx.dev/configuration/settings.html for details on supported values.

Type: TOML value

Default:

{ }

Example:

settings = {
  disable_tools = [ "node" ];
  experimental = true;
  verbose = false;
};

tool_alias = {
  node.versions = {
    my_custom_node = "20";
  };
};

tools = {
  node = "lts";
  python = ["3.10" "3.11"];
};

Declared by: