Where Is the WezTerm Config File?
WezTerm config file lookup order across Windows, macOS and Linux, from home directory to config folder.
Last updated
WezTerm reads a single Lua config file, but it looks in two places: a dotfile in home, then a wezterm folder in the config directory. First match wins.
That fallback order causes most confusion. Stale dotfiles silently override the config-folder file people think they are editing.
Where WezTerm stores this, by platform
%USERPROFILE%\.config\wezterm\wezterm.lua
Fallback path is %USERPROFILE%\.wezterm.lua, which takes precedence when present. wezterm.lua is the filename in both spots.
~/.config/wezterm/wezterm.lua
Fallback is ~/.wezterm.lua. Remove it if edits to the config folder seem ignored.
~/.config/wezterm/wezterm.lua
Standard XDG location with the same home-dotfile fallback. Reload with the built-in reload action after edits.
Frequently asked questions
Which config wins if I have two?
WezTerm checks $HOME/.wezterm.lua first, then the config folder. When both exist, the home file wins. Delete or merge the spare copy.
Notice an outdated path? Let us know.