Installation

Git Town ships as a single self-contained binary. It doesn't bundle a Git client but uses the native Git installation on your machine.

Packaging status

macOS

The easiest way to install Git Town on macOS is via Homebrew:

brew install git-town

Git Town is available via MacPorts. You can also install Git Town manually or compile from source.

Windows

The easiest way to install Git Town on Windows is to download the Windows installer and run it. You can also install Git Town via scoop:

scoop bucket add org https://github.com/git-town/scoop.git
scoop install git-town

You can also install Git Town manually or compile from source.

If you use the Windows Subsystem for Linux, please install wsl-open to allow the commands git town repo and git town new-pull-request to open a browser window for you.

Linux

On Debian-based systems, download the .deb file matching your CPU architecture and run:

sudo apt-get install git-town_9.0.1_linux_intel_64.deb

On RedHat-based systems download the .rpm file matching your CPU architecture and run

rpm -i git-town_9.0.1_linux_intel_64.rpm

On Arch Linux, install the git-town package from the AUR.

You can install Git Town via Homebrew for Linux:

brew install git-town

You can also install Git Town manually or compile from source.

manual installation

curl https://git-town.com/install.sh | sh

For a fully custom installation, download the archive matching your CPU architecture, extract it, and move the git-town executable into a directory listed in your $PATH, for example /usr/local/bin.

compile from source

If you have the Go compiler installed, you can compile the latest version of Git Town from source by running:

go get github.com/git-town/git-town

New releases

Subscribe to the Git Town release feed to get notifications about new releases.

Uninstall

To remove Git Town from your system:

  1. Remove Git Town's aliases: git town aliases false
  2. Remove the Git Town configuration from your repositories: in each repo, run git town config reset
  3. If your operating system or package manager provides an uninstaller for Git Town, run it. If you installed Git Town manually, delete the binary.