Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

browser

By default, Git Town launches your system’s default browser by trying common commands like open, xdg-open, or x-www-browser.

You can override this behavior to use a specific browser. Disable browser launching entirely by setting this option to (none) or an empty string.

CLI flag

The propose and repo commands allow setting the browser via the --browser CLI flag.

For example, to open the repo homepage using Firefox, run:

git-town repo --browser=firefox

config file

[hosting]
browser = "<browser executable>"

To disable the browser:

[hosting]
browser = "(none)"

Or

[hosting]
browser = ""

Git metadata

git config [--global] git-town.browser '<browser executable>'

The optional --global flag applies this setting to all Git repositories on your local machine. When not present, the setting applies to the current repo.

environment variable

Git Town uses the BROWSER environment variable that is also used by other tools.