From 4d453d6c545d5de3bbec272d19a65cb474ca161b Mon Sep 17 00:00:00 2001 From: Shay Elkin <2046772+shayelkin@users.noreply.github.com> Date: Thu, 12 Mar 2026 11:22:56 -0700 Subject: [PATCH] Fix: Have config file locations to match edit.zig (Bug #441) The docs, as exists, detail config file locations that doesn't match those described in the current version of edit.zig. This changes it to match. --- docs/config/index.mdx | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/config/index.mdx b/docs/config/index.mdx index 341f3575..18289f89 100644 --- a/docs/config/index.mdx +++ b/docs/config/index.mdx @@ -35,14 +35,18 @@ Ghostty is configured using a text-based configuration file. ### File Location -The configuration file, `config`, is loaded from these locations in the following order: +The configuration file is named `config.ghostty` (or `config` before 1.2.3), +is loaded from these locations in the following order: -#### XDG configuration Path (all platforms): -- `$XDG_CONFIG_HOME/ghostty/config`. -- if **XDG_CONFIG_HOME** is not defined, it defaults to `$HOME/.config/ghostty/config`. #### macOS-specific Path (macOS only): +- `$HOME/Library/Application\ Support/com.mitchellh.ghostty/config.ghostty`. - `$HOME/Library/Application\ Support/com.mitchellh.ghostty/config`. -- macOS also supports the XDG configuration path mentioned above. +- macOS also supports the XDG configuration path mentioned below. + +#### XDG configuration Path (all platforms): +- `$XDG_CONFIG_HOME/ghostty/config.ghostty` +- `$XDG_CONFIG_HOME/ghostty/config` +- if **XDG_CONFIG_HOME** is not defined, it defaults to `$HOME/.config/ghostty/config`. If both locations exist, they are loaded in the order above with conflicting values in later files overriding earlier ones.