---
title: Configuration
description: config.toml, Settings, and how changes apply.
url: https://docs-v3-preview.elastic.dev/configuration
---

# Configuration
Everything Heed can be told lives in one file, `~/.config/heed/config.toml` (or `$XDG_CONFIG_HOME/heed/config.toml`).
Heed writes it with comments the first time it opens, showing every key with its default.
- **Saving applies it.** Heed watches the file; there is nothing to reload.
- **Mistakes never take the rest down.** A value that does not fit is reported in the status bar, and its default
  kept. A syntax error keeps the last good config in use.
- **Settings edits the same file** (`⌘,`), keeping your comments, for everything but key bindings.

![A config problem reported in the status bar](https://docs-v3-preview.elastic.dev/images/shots/configuration/problem.png)
- [Settings](https://docs-v3-preview.elastic.dev/configuration/settings): the Settings window, section by section.
- [config.toml reference](https://docs-v3-preview.elastic.dev/configuration/reference): every key and its default.
- [Finding git and gh](https://docs-v3-preview.elastic.dev/configuration/tools): how Heed finds the tools it runs.