Git & Version Control · Developer Error Resolution Lab

Fix Git Error: 'fatal: refusing to merge unrelated histories'

Merge repositories initialized independently with different initial commits using --allow-unrelated-histories.

Fix Guide:

Triggered Error Message:

fatal: refusing to merge unrelated histories

Customize Solution for Your Environment

Remote Branch Name

# Run pull with unrelated histories enabled:
git pull origin main --allow-unrelated-histories

# Resolve any merge conflicts, then commit:
git add .
git commit -m "Merge unrelated remote history"
git push origin main

Root Cause & Mechanism Analysis

Why does this error occur?

Occurs when pulling from a remote repository that was initialized independently (e.g. with a README generated on GitHub) while having existing local commits.