Skip to content

Git config for CI runners: quick reference ​

Safe directory (always needed in containers) ​

bash
git config --global safe.directory '*'

Protocol v2 ​

bash
git config --global protocol.version 2
bash
git config --global http.postBuffer 524288000
git config --global http.version HTTP/1.1
git config --global http.keepAlive 5
git config --global http.lowSpeedLimit 1000
git config --global http.lowSpeedTime 300

Core filesystem performance ​

bash
git config --global core.preloadIndex true
git config --global core.untrackedCache true
git config --global core.fsmonitor true
git config --global core.splitIndex true
git config --global core.checkStat minimal

Compression (saves bandwidth at CPU cost) ​

bash
git config --global core.compression 9
git config --global core.looseCompression 9
git config --global pack.compression 9
git config --global pack.deltaCacheSize 256m
git config --global pack.windowMemory 512m
git config --global pack.threads 0
git config --global pack.window 250

CI commit identity ​

bash
git config --global user.name "CI Pipeline"
git config --global user.email "ci@pipeline.local"
# Or use env vars (avoids race on shared runners)
export GIT_AUTHOR_NAME="CI Pipeline"
export GIT_AUTHOR_EMAIL="ci@pipeline.local"
export GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"
export GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"

Merge and diff ​

bash
git config --global diff.algorithm histogram
git config --global diff.renameLimit 2000
git config --global merge.conflictStyle zdiff3
git config --global pull.ff only

Maintenance for persistent runners ​

bash
git config --global maintenance.strategy incremental
git config --global maintenance.auto true
git config --global core.commitGraph true
git config --global gc.writeCommitGraph true
git config --global gc.auto 500
git config --global gc.autoDetach false

Disable advice ​

bash
# Git 2.38+
git config --global advice.* false
# Older versions: set individual keys
git config --global advice.detachedHead false
git config --global advice.statusHints false
git config --global advice.implicitIdentity false

Template for runner images ​

Full config template: docs/devops-workflows/git-config-ci-runners.md

Config audit one-liner ​

bash
git config --list --show-origin | sort
git config --global --list

Per-job override via env (Git 2.32+) ​

bash
export GIT_CONFIG_COUNT=2
export GIT_CONFIG_KEY_0=safe.directory
export GIT_CONFIG_VALUE_0=*
export GIT_CONFIG_KEY_1=protocol.version
export GIT_CONFIG_VALUE_1=2

Git Master — Git Reference for Every Skill Level