Where Is the kitty Config File?
kitty uses kitty.conf in the kitty folder under your user config directory. The same path applies on macOS and Linux.
Last updated
kitty looks in OS config directories for kitty.conf. If the file is missing, open it from inside kitty to create a commented default file.
You can point kitty at another file with the config option or the KITTY_CONFIG_DIRECTORY variable. Secondary files can be pulled in with include directives.
Where kitty stores this, by platform
/Users/<username>/.config/kitty/kitty.conf
<username> is your macOS account name. Create the kitty folder if needed. Use include to split settings across machines.
/home/<username>/.config/kitty/kitty.conf
<username> is your Linux user name. Respects XDG_CONFIG_HOME if set. Use include to split settings across machines.
Frequently asked questions
How do I create a default kitty.conf?
Press ctrl shift f2 to open the config inside kitty. If no file exists, kitty writes one with defaults and comments that you can edit and reload.
How do I reload after edits?
Save the file and kitty reloads automatically when auto reload is on. You can also press ctrl shift f5 or send SIGUSR1 to the kitty process.
Notice an outdated path? Let us know.