# mise.toml reference Every key mise reads from a mise.toml, generated from https://mise.jdx.dev/schema/mise.json, with a file for each top-level section. Names in angle brackets, such as `tasks.`, stand for a key you choose, and `[].` is a key of each table in a list. The same reference as a page you can filter and browse: https://mise.jdx.dev/configuration/reference.html - [`_`](https://mise.jdx.dev/configuration/reference/_.md) - [`alias`](https://mise.jdx.dev/configuration/reference/alias.md): custom shorthands; same keys as `tool_alias` - [`bootstrap`](https://mise.jdx.dev/configuration/reference/bootstrap.md): machine-global bootstrapping (system packages, repos, macOS defaults, launchd agents, login shell) (364 keys) - [`daemon_groups`](https://mise.jdx.dev/configuration/reference/daemon_groups.md): Experimental named groups of project daemons. Members are daemon names or other group names declared in the same project. (2 keys) - [`daemon_providers`](https://mise.jdx.dev/configuration/reference/daemon_providers.md): Experimental shared servers owned by the user. Only allowed in global configuration. (12 keys) - [`daemons`](https://mise.jdx.dev/configuration/reference/daemons.md): Experimental project daemons: custom pitchfork commands or managed presets. (23 keys) - [`daemons_settings`](https://mise.jdx.dev/configuration/reference/daemons_settings.md): Experimental project-wide daemon options. (2 keys) - [`deps`](https://mise.jdx.dev/configuration/reference/deps.md): configure deps providers (27 keys) - [`doctor`](https://mise.jdx.dev/configuration/reference/doctor.md): Project diagnostic checks, run explicitly with mise doctor project. (9 keys) - [`dotenv`](https://mise.jdx.dev/configuration/reference/dotenv.md): dotenv file(s) to load. Deprecated; use env._.file instead. This will be removed in mise 2027.4.0. - [`dotfile_groups`](https://mise.jdx.dev/configuration/reference/dotfile_groups.md): named directory trees of dotfiles, applied with `mise dotfiles apply` or `mise bootstrap` while [bootstrap] dotfile_groups selects them (or is unset) (10 keys) - [`dotfiles`](https://mise.jdx.dev/configuration/reference/dotfiles.md): dotfiles applied with `mise dotfiles apply` or `mise bootstrap`, keyed by target path or a logical name when every variant overrides the target; an omitted source for the latter resolves the relative key under dotfiles.root (27 keys) - [`env`](https://mise.jdx.dev/configuration/reference/env.md): environment variables to set (33 keys) - [`env_file`](https://mise.jdx.dev/configuration/reference/env_file.md): dotenv file(s) to load. Deprecated; use env._.file instead. This will be removed in mise 2027.4.0. - [`env_path`](https://mise.jdx.dev/configuration/reference/env_path.md): PATH entries to add. Deprecated; use env._.path instead. This will be removed in mise 2027.4.0. - [`experimental_monorepo_root`](https://mise.jdx.dev/configuration/reference/experimental_monorepo_root.md): deprecated alias of monorepo_root - [`history`](https://mise.jdx.dev/configuration/reference/history.md): dotfiles history: what is never captured, reload commands, and the setup repository (https://mise.jdx.dev/history.html) (10 keys) - [`hooks`](https://mise.jdx.dev/configuration/reference/hooks.md): hooks to run on events like cd, enter, leave (17 keys) - [`include`](https://mise.jdx.dev/configuration/reference/include.md): config files merged into this one, ranking just below it: a local path (relative to this file), git:://.toml?ref= or oci::/[:tag|@sha256:] (the artifact holds a mise.toml). Paranoid mode requires a commit sha or digest for remote includes and rejects local ones; otherwise a branch or tag is refreshed after fetch_remote_versions_cache - [`min_version`](https://mise.jdx.dev/configuration/reference/min_version.md): minimum version of mise required to use this config (2 keys) - [`monorepo`](https://mise.jdx.dev/configuration/reference/monorepo.md): configuration for monorepo task discovery (15 keys) - [`monorepo_root`](https://mise.jdx.dev/configuration/reference/monorepo_root.md): marks this config as a monorepo root for task path syntax - [`oci`](https://mise.jdx.dev/configuration/reference/oci.md): configuration for `mise oci build` (16 keys) - [`plugins`](https://mise.jdx.dev/configuration/reference/plugins.md): plugins to use (1 key) - [`redactions`](https://mise.jdx.dev/configuration/reference/redactions.md): env or vars keys to redact from logs - [`secrets`](https://mise.jdx.dev/configuration/reference/secrets.md): Sources for mise secrets: values resolved only when mise starts a task or `mise x` command that was granted them. Project config only. (2 keys) - [`settings`](https://mise.jdx.dev/configuration/reference/settings.md): mise settings - [`shell_alias`](https://mise.jdx.dev/configuration/reference/shell_alias.md): shell aliases (1 key) - [`task_config`](https://mise.jdx.dev/configuration/reference/task_config.md): configuration for task execution and management (18 keys) - [`task_templates`](https://mise.jdx.dev/configuration/reference/task_templates.md): task templates that can be extended by tasks via extends (40 keys) - [`tasks`](https://mise.jdx.dev/configuration/reference/tasks.md): task runner tasks (96 keys) - [`tool_alias`](https://mise.jdx.dev/configuration/reference/tool_alias.md): Tool version aliases (5 keys) - [`tool_config`](https://mise.jdx.dev/configuration/reference/tool_config.md): policy for tools declared by this config root (1 key) - [`tools`](https://mise.jdx.dev/configuration/reference/tools.md): dev tools to use (282 keys) - [`vars`](https://mise.jdx.dev/configuration/reference/vars.md): variables to set for use in config templates (15 keys) - [`watch_files`](https://mise.jdx.dev/configuration/reference/watch_files.md): files to watch for changes and run scripts when modified (4 keys) - [`wrappers`](https://mise.jdx.dev/configuration/reference/wrappers.md): commands that intercept a binary name before delegating to the active toolset (5 keys)