Where Is the Lazygit Config File?
Lazygit uses a single global config.yml plus optional repo local overrides. The global path follows OS config conventions.
Last updated
The global file is named config.yml inside a lazygit config directory. Run lazygit --print-config-dir to print the effective directory on the current machine.
Legacy installs used a jesseduffield vendor subdirectory. Repo local files .lazygit.yml and .git/lazygit.yml still layer on top of the global file where present.
Where Lazygit stores this, by platform
%LOCALAPPDATA%\lazygit\config.yml
Default location (example: C:\Users\<user>\AppData\Local\lazygit\config.yml). Also detected at %APPDATA%\lazygit\config.yml. Legacy path was %APPDATA%\jesseduffield\lazygit\config.yml.
~/Library/Application Support/lazygit/config.yml
Default on macOS. If XDG_CONFIG_HOME is set (example: export XDG_CONFIG_HOME="$HOME/.config"), the effective path becomes $XDG_CONFIG_HOME/lazygit/config.yml. Legacy path added jesseduffield segment.
~/.config/lazygit/config.yml
Full form is $XDG_CONFIG_HOME/lazygit/config.yml else ~/.config/lazygit/config.yml. Legacy path was ~/.config/jesseduffield/lazygit/config.yml. Override dir with CONFIG_DIR=/path/to/dir and files with LG_CONFIG_FILE=/path/to.yml (comma separated for multiples).
Frequently asked questions
How do I use a custom lazygit config location?
Set CONFIG_DIR to the directory containing config.yml, or set LG_CONFIG_FILE to one or more explicit file paths. LG_CONFIG_FILE entries must exist or lazygit reports an error.
Where do per repo settings go?
Place overrides in .lazygit.yml at the repo root or .git/lazygit.yml inside the git dir. They combine with the global config.yml for that repo only.
Notice an outdated path? Let us know.