Where Does git-town Store Config?
git-town keeps global defaults in ~/.git-town.toml with per repo branch types and ship settings in .git/config, managed through git town commands.
Last updated
git-town splits config between global defaults and per repo annotations. The TOML file in home holds hosting platform, sync strategy, and display choices. Individual repos record branch types and parentage in their git config.
That split mirrors how the tool thinks: global habits plus per project workflow. New machines need the TOML copy while repos carry their own metadata on clone. The CLI remains the safest editor since it validates as it writes.
Where git-town stores this, by platform
~/.git-town.toml
Global defaults for hosting, sync, and display. Per repo branch data lives in .git/config. Migrate with file copy plus fresh clones.
~/.git-town.toml
Same TOML plus repo config layout as Linux. CLI config commands work identically. Version control the TOML with dotfiles.
%USERPROFILE%\.git-town.toml
Windows mirrors the home TOML and repo config split. Use the CLI to edit safely. Repos annotate independently per clone.
Frequently asked questions
How do I configure git-town?
Run git town config to view and set values, which writes the TOML and repo config correctly. Hand editing works but the CLI validates choices. Per repo overrides live in .git/config under town keys.
How do I migrate git-town settings?
Copy ~/.git-town.toml for global defaults like hosting platform and sync strategy. Each repo contributes its own branch annotations separately. Repos without town config simply use global behavior.
Notice an outdated path? Let us know.