Where Is the Ghostty Config File?
Ghostty loads a plain text config file from your user config folder. On macOS it also checks a native Application Support path.
Last updated
Ghostty config is optional. Without a file it runs with built in defaults, which suits many users with no extra setup.
When present, the file is named config or config.ghostty. If both XDG and macOS specific files exist, both load with later values winning.
Where Ghostty stores this, by platform
/home/<username>/.config/ghostty/config
<username> is your Linux user name. Use config.ghostty on recent releases, config on older ones. Create the ghostty folder if needed.
/Users/<username>/.config/ghostty/config
<username> is your macOS account name. Same XDG path works on macOS. Later files override earlier ones when both locations exist.
/Users/<username>/Library/Application Support/com.mitchellh.ghostty/config
<username> is your macOS account name. Native macOS path for users who prefer Application Support. Library is hidden by default.
Frequently asked questions
Which filename should I use?
Use config.ghostty on current releases. Older builds used config without an extension, and both names are still checked in order.
How do I reload the config?
Press ctrl shift comma on Linux or cmd shift comma on macOS with default bindings. Some options need a restart or only affect new windows.
Notice an outdated path? Let us know.