Where Is the Starship Config File?
Starship cross-shell prompt config file location on Linux, macOS and Windows.
Last updated
Starship reads one TOML file from the XDG config home on Unix and from the profile config folder on Windows. Every module, format string and disabled toggle lives there.
No config means sensible defaults. The file only needs entries for what you change, so most are short.
Where Starship stores this, by platform
~/.config/starship.toml
Create it if missing; defaults apply otherwise. Override with the STARSHIP_CONFIG variable.
~/.config/starship.toml
Same path. Works across bash, zsh, fish and others via their init lines.
%USERPROFILE%\.config\starship.toml
Windows equivalent of the XDG path. Same TOML format as other platforms.
Frequently asked questions
How do I use a custom Starship config path?
Set STARSHIP_CONFIG to the file path before init. Useful for per-project or per-machine prompt variants without touching the default.
How do I debug what my prompt shows?
Run starship explain to see which modules render and why. It prints active modules with values, which beats guessing against the docs.
Notice an outdated path? Let us know.