How to fix fatal: Server does not support deepen in Git

GitINTERMEDIATEMEDIUM

This error occurs when attempting to deepen a shallow clone with git fetch --deepen on a Git server that lacks protocol support for the deepen capability. The deepen feature requires Git protocol version 2 support on the remote server.

What this error means

This error indicates that the remote Git server does not support the "deepen" capability in the Git protocol. The --deepen option allows you to incrementally add more history to a shallow clone by specifying how many additional commits to fetch from the current shallow boundary, rather than from the branch tip. The deepen capability was introduced in Git protocol version 2 and requires server-side support. Older Git server versions (pre-2.19), certain Git hosting providers with legacy infrastructure, or servers that have disabled protocol v2 will reject fetch requests with the --deepen flag. This is particularly common in CI/CD environments where shallow clones are used to speed up builds, and subsequent operations try to deepen the history to access older commits for operations like rebasing or viewing full diffs.

How to fix "fatal: Server does not support deepen"

1Check remote server Git version

First, verify what Git version the remote server is running to confirm if it supports protocol v2:

bash

# Check if the server advertises protocol v2
GIT_TRACE_PACKET=1 git ls-remote origin 2>&1 | grep "version 2"

# Or check server capabilities
git ls-remote --symref origin HEAD

If you don't see protocol v2 advertised, the server doesn't support --deepen.

2Use --depth instead of --deepen

Replace --deepen with --depth to specify an absolute depth from the branch tip:

bash

# Instead of this (which requires deepen support):
git fetch --deepen=100

# Use this (works with all Git servers):
git fetch --depth=200  # Adjust to total desired depth

Note that --depth counts from the branch tip, so if your shallow clone has depth 100 and you want 100 more commits, use --depth=200.

3Convert to full clone with --unshallow

If you need the complete history, convert the shallow clone to a full clone:

bash

# Fetch all history and convert to full clone
git fetch --unshallow

# Verify the repository is no longer shallow
git rev-parse --is-shallow-repository  # Should output "false"

This fetches all remaining history and removes the shallow boundary entirely. This works with all Git server versions.

4Use --shallow-since for date-based deepening

As an alternative to --deepen, fetch history back to a specific date:

bash

# Fetch all commits since a specific date
git fetch --shallow-since="2024-01-01"

# Or fetch commits from the last 90 days
git fetch --shallow-since="90 days ago"

This provides more predictable results than --deepen and works on servers with protocol v2 support.

5Configure CI to use full clones

If you're encountering this in CI/CD, modify your pipeline configuration to avoid shallow clones:

yaml

# GitHub Actions
- uses: actions/checkout@v4
  with:
    fetch-depth: 0  # Full clone, no shallow boundary

# GitLab CI
variables:
  GIT_DEPTH: 0  # Disable shallow clone

# CircleCI (in .circleci/config.yml)
checkout:
  post:
    - git fetch --unshallow || true

While this increases clone time, it prevents all shallow-clone-related issues.

How to fix fatal: Server does not support deepen in Git

What this error means

Typical symptoms

Common causes

How to fix "fatal: Server does not support deepen"

Advanced notes

Related errors

Official resources & further reading