Current documented limits
| Constraint | Current value | Scope | Verified source |
|---|---|---|---|
| recommended on-disk repository sizeOn-disk size refers to the compressed .git directory and is a repository-health guideline. | 10 GB recommended maximum | GitHub repositories | GitHubAug 22, 2026 |
| regular Git file sizeFiles beyond the hard block require Git LFS or an external release/storage path. | 50 MiB warning; 100 MiB hard block; 25 MiB browser upload | Regular repositories | GitHubAug 22, 2026 |
| single push sizeThe limit is enforced even when the repository itself can remain supported. | 2 GiB | Git transport | GitHubAug 22, 2026 |
| maximum Git LFS objectStorage and download bandwidth are metered separately from the per-file ceiling. | Free/Pro: 2 GB; Team: 4 GB; Enterprise Cloud: 5 GB | Git LFS | GitHubAug 22, 2026 |
How to apply GitHub limits safely
The monitored baseline covers recommended on-disk repository size, regular Git file size, single push size, maximum Git LFS object. Treat these as separate constraints rather than one platform-wide capacity number: a workload can fit one row and still fail another because the plan, model, endpoint, runtime, region, invocation mode, or account scope differs.
- Match the production workload to the exact scope printed beside each value and confirm it in the active GitHub console, configuration, or response headers.
- Measure the serialized request, token volume, duration, concurrency, storage, or connection demand at realistic percentiles, then preserve headroom for bursts and retries.
- Check every adjacent layer—client, SDK, gateway, proxy, queue, database, and downstream service—for a smaller effective limit before changing architecture.
Specific limit pages
These pages exist because the constraint has a distinct implementation or troubleshooting intent. Closely related keyword variations stay consolidated.
GitHub Repository Size Limits
GitHub Repository Size Limits, verified against GitHub's official documentation with scope, implementation impact, caveats, and a direct check.
GitHub File Size Limits
GitHub File Size Limits, verified against GitHub's official documentation with scope, implementation impact, caveats, and a direct check.
GitHub Push Size Limit
GitHub Push Size Limit, verified against GitHub's official documentation with scope, implementation impact, caveats, and a direct check.
GitHub Git LFS File Limits by Plan
GitHub Git LFS File Limits by Plan, verified against GitHub's official documentation with scope, implementation impact, caveats, and a direct check.