Installation

Gity is distributed as a single binary that works on Linux, macOS, and Windows.

Requirements

• Git 2.37+ — Required for fsmonitor protocol v2 support
• Rust 1.75+ — Only if building from source

Check your Git version:

git --version
# Should be 2.37 or higher

Installation Methods

From Source (Recommended)LinuxmacOSWindows

If you have Rust installed:

cargo install --path crates/gity

Or clone and build:

git clone https://github.com/yourusername/gity
cd gity
cargo build --release
# Binary is at ./target/release/gity

Debian/Ubuntu (.deb)

# Download from releases
wget https://github.com/yourusername/gity/releases/latest/download/gity_amd64.deb
sudo dpkg -i gity_amd64.deb

AppImage

wget https://github.com/yourusername/gity/releases/latest/download/gity-x86_64.AppImage
chmod +x gity-x86_64.AppImage
./gity-x86_64.AppImage

Homebrew (coming soon)

brew install gity

Package Installer

Download the .pkg installer from releases.

MSI Installer

Download the MSI installer from releases.

Scoop (coming soon)

scoop install gity

Verify Installation

After installation, verify Gity is working:

gity --version

Next Steps

Once installed, head to the Quick Start guide to accelerate your first repository.

Uninstallation

From SourceLinux (.deb)macOSWindows

cargo uninstall gity

sudo dpkg -r gity

Run the uninstaller or remove manually:

sudo rm /usr/local/bin/gity

Use "Add or Remove Programs" in Windows Settings, or run:

msiexec /x gity.msi

Before uninstalling, make sure to unregister all repositories:

gity list
gity unregister /path/to/repo1
gity unregister /path/to/repo2
gity daemon stop

This ensures Git configuration is cleaned up properly.