Skip to content

Telemetry

AkashRajpurohit edited this page Feb 14, 2026 · 1 revision

Overview

Starting from v0.21.0, git-sync collects anonymous usage telemetry via PostHog. This helps the maintainers understand which platforms and features are popular, and how syncs perform across different environments.

No personally identifiable information (PII) is ever collected. No repository names, tokens, usernames, or file contents are sent.

What is collected?

A single sync_completed event is sent at the end of each sync run with the following properties:

Property Type Description
platform string github, gitlab, bitbucket, forgejo, gitea
clone_type string bare, mirror, shallow, full
concurrency int Number of concurrent sync workers
include_wiki bool Whether wiki sync is enabled
include_issues bool Whether issue backup is enabled
include_forks bool Whether forked repos are included
repos_success int Count of repos synced successfully
repos_failed int Count of repos that failed
wikis_success int Count of wikis synced successfully
wikis_failed int Count of wikis that failed
issues_success int Count of issue backups that succeeded
issues_failed int Count of issue backups that failed
app_version string git-sync version
os string Operating system (darwin, linux, windows)
arch string CPU architecture (amd64, arm64)

An anonymous device ID (UUID) is generated on first run and stored at ~/.config/git-sync/.device-id. This is used solely to count unique installations — it is not linked to any personal information.

How to opt out

You can disable telemetry in any of these ways:

Config file

telemetry:
  enabled: false

Environment variable

export GIT_SYNC_NO_TELEMETRY=1

When telemetry is disabled, no PostHog client is created and no network calls are made.

Clone this wiki locally