LinuxWindows

Where Is the Jujutsu (jj) Config File?

Jujutsu jj config.toml locations on Linux and Windows plus repo-level config.

Last updated

Jujutsu reads TOML config from user-level files with repo-level overrides inside each repository. Identity, signing, aliases and UI defaults belong in the user file.

Repos additionally read .jj/repo/config.toml for shared settings. Keep personal identity in the user file and project conventions in the repo one.

Where Jujutsu stores this, by platform

Linux
~/.config/jj/config.toml

Main user config for name, email, signing and aliases. Repo overrides live at .jj/repo/config.toml inside each checkout. Create the file if missing; jj works without it until you want identity set.

Windows
%APPDATA%\jj\config.toml

Same user config role as Linux. Confirm the exact subfolder on your install before scripting, since jj's Windows paths have shifted between releases.

Frequently asked questions

How do I set my name in Jujutsu?

Add user.name and user.email under the [user] table in config.toml above. Repos inherit it unless their own config overrides.

Where is repo-specific jj config?

In .jj/repo/config.toml at the repository root. Use it for hooks-adjacent conventions shared with collaborators.

Notice an outdated path? Let us know.