# 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 ## Tools - [`tools`](https://mise.jdx.dev/configuration/reference/tools.md): dev tools to use (285 keys). Guide: [Dev tools](https://mise.jdx.dev/dev-tools/) - [`tool_alias`](https://mise.jdx.dev/configuration/reference/tool_alias.md): Tool version aliases (5 keys). Guide: [Tool aliases](https://mise.jdx.dev/dev-tools/aliases.html) - [`tool_config`](https://mise.jdx.dev/configuration/reference/tool_config.md): policy for tools declared by this config root (1 key). Guide: [Tool policy](https://mise.jdx.dev/configuration.html#tool-config) - [`plugins`](https://mise.jdx.dev/configuration/reference/plugins.md): plugins to use (1 key). Guide: [Plugins](https://mise.jdx.dev/configuration.html#plugins) - [`wrappers`](https://mise.jdx.dev/configuration/reference/wrappers.md): commands that intercept a binary name before delegating to the active toolset (5 keys). Guide: [Command wrappers](https://mise.jdx.dev/dev-tools/shims.html#command-wrappers) ## Environment - [`env`](https://mise.jdx.dev/configuration/reference/env.md): environment variables to set (33 keys). Guide: [Environment variables](https://mise.jdx.dev/environments/) - [`vars`](https://mise.jdx.dev/configuration/reference/vars.md): variables to set for use in config templates (15 keys). Guide: [Config variables](https://mise.jdx.dev/configuration/vars.html) - [`redactions`](https://mise.jdx.dev/configuration/reference/redactions.md): env or vars keys to redact from logs. Guide: [Redaction](https://mise.jdx.dev/environments/secrets/#redaction) - [`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). Guide: [fnox](https://mise.jdx.dev/environments/secrets/fnox.html) ## Tasks - [`tasks`](https://mise.jdx.dev/configuration/reference/tasks.md): task runner tasks (96 keys). Guide: [Tasks](https://mise.jdx.dev/tasks/) - [`task_config`](https://mise.jdx.dev/configuration/reference/task_config.md): configuration for task execution and management (18 keys). Guide: [Task configuration](https://mise.jdx.dev/tasks/task-configuration.html#task-config-options) - [`task_templates`](https://mise.jdx.dev/configuration/reference/task_templates.md): task templates that can be extended by tasks via extends (40 keys). Guide: [Task templates](https://mise.jdx.dev/tasks/templates.html) - [`monorepo`](https://mise.jdx.dev/configuration/reference/monorepo.md): configuration for monorepo task discovery (15 keys). Guide: [Monorepo tasks](https://mise.jdx.dev/tasks/monorepo.html) - [`monorepo_root`](https://mise.jdx.dev/configuration/reference/monorepo_root.md): marks this config as a monorepo root for task path syntax. Guide: [Monorepo tasks](https://mise.jdx.dev/tasks/monorepo.html) ## Hooks and shell - [`hooks`](https://mise.jdx.dev/configuration/reference/hooks.md): hooks to run on events like cd, enter, leave (17 keys). Guide: [Hooks](https://mise.jdx.dev/hooks.html) - [`watch_files`](https://mise.jdx.dev/configuration/reference/watch_files.md): files to watch for changes and run scripts when modified (4 keys). Guide: [Hooks](https://mise.jdx.dev/hooks.html) - [`shell_alias`](https://mise.jdx.dev/configuration/reference/shell_alias.md): shell aliases (1 key). Guide: [Shell aliases](https://mise.jdx.dev/shell-aliases.html) ## Config file - [`settings`](https://mise.jdx.dev/configuration/reference/settings.md): mise settings. Guide: [Settings](https://mise.jdx.dev/configuration/settings.html) - [`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. Guide: [include](https://mise.jdx.dev/configuration.html#include) - [`min_version`](https://mise.jdx.dev/configuration/reference/min_version.md): minimum version of mise required to use this config (2 keys). Guide: [Minimum mise version](https://mise.jdx.dev/configuration.html#minimum-mise-version) - [`doctor`](https://mise.jdx.dev/configuration/reference/doctor.md): Project diagnostic checks, run explicitly with mise doctor project. (9 keys). Guide: [Project diagnostics](https://mise.jdx.dev/configuration/project-diagnostics.html) - [`_`](https://mise.jdx.dev/configuration/reference/_.md): free-form data for your own use; mise never reads it. Guide: [Free-form data](https://mise.jdx.dev/configuration.html#free-form-data) ## Project services - [`deps`](https://mise.jdx.dev/configuration/reference/deps.md): configure deps providers (27 keys). Guide: [Project dependencies](https://mise.jdx.dev/dev-tools/deps.html) - [`oci`](https://mise.jdx.dev/configuration/reference/oci.md): configuration for `mise oci build` (16 keys). Guide: [OCI images](https://mise.jdx.dev/dev-tools/mise-oci.html) - [`daemons`](https://mise.jdx.dev/configuration/reference/daemons.md): Experimental project daemons: custom pitchfork commands or managed presets. (23 keys). Guide: [Daemons](https://mise.jdx.dev/daemons.html) - [`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). Guide: [Daemon groups](https://mise.jdx.dev/daemons.html#groups) - [`daemons_settings`](https://mise.jdx.dev/configuration/reference/daemons_settings.md): Experimental project-wide daemon options. (2 keys). Guide: [Ports, URLs, and worktrees](https://mise.jdx.dev/daemons/worktrees.html#namespaces) - [`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). Guide: [Share daemons across projects](https://mise.jdx.dev/daemons/sharing.html) ## Machine setup - [`bootstrap`](https://mise.jdx.dev/configuration/reference/bootstrap.md): machine-global bootstrapping (system packages, repos, macOS defaults, launchd agents, login shell) (364 keys). Guide: [Bootstrap](https://mise.jdx.dev/bootstrap.html) - [`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). Guide: [Dotfiles](https://mise.jdx.dev/dotfiles.html) - [`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). Guide: [Dotfile groups](https://mise.jdx.dev/dotfiles/groups.html) - [`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). Guide: [Dotfiles history](https://mise.jdx.dev/dotfiles/history.html) ## Deprecated - [`alias`](https://mise.jdx.dev/configuration/reference/alias.md): custom shorthands; same keys as `tool_alias`. Guide: [Tool aliases](https://mise.jdx.dev/dev-tools/aliases.html) - [`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.. Guide: [Environment variables](https://mise.jdx.dev/environments/) - [`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.. Guide: [Environment variables](https://mise.jdx.dev/environments/) - [`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.. Guide: [Environment variables](https://mise.jdx.dev/environments/) - [`experimental_monorepo_root`](https://mise.jdx.dev/configuration/reference/experimental_monorepo_root.md): deprecated alias of monorepo_root. Guide: [Monorepo tasks](https://mise.jdx.dev/tasks/monorepo.html)