Space limits for GitHub repositories and GitHub Pages:29.03.26

**GitHub Repositories (General):**

*   **Repository Size Limit:** GitHub strongly recommends keeping individual repositories **under 1 GB**. While there isn't a hard technical limit that prevents you from exceeding this, repositories larger than 1 GB are generally discouraged.

*   **Large Files:** GitHub is *not* designed for hosting large binary files or datasets. If you have large files (e.g., videos, audio, large datasets), consider using Git Large File Storage (LFS).

*   **Git LFS:** Git LFS allows you to store large files separately from your Git repository.  Instead of storing the large files directly in the repository, Git LFS stores pointers to the files, which are then stored on a separate LFS server.  GitHub provides Git LFS support.

*   **Git LFS Storage Quota:**  The amount of Git LFS storage you get depends on your GitHub plan:
        *   **Free:** 1 GB storage, 1 GB bandwidth per month
        *   **Pro:** 2 GB storage, 2 GB bandwidth per month
        *   **Team:** 100 GB storage, 100 GB bandwidth per month (shared among all members)
        *   **Enterprise:** 1 TB storage, 1 TB bandwidth per month (shared among all members)

*   **Repository Size Best Practices:**
    *   **Keep repositories small:**  Smaller repositories are easier to clone, fetch, and manage.
    *   **Use Git LFS for large files:**  Don't store large binary files directly in your repository.
    *   **Consider splitting large projects:** If you have a very large project, consider breaking it down into smaller, more manageable repositories.
    *   **Remove unnecessary files:**  Clean up your repository by removing unnecessary files or large files that are no longer needed.  Be careful when rewriting history!

**GitHub Pages:**

*   **Repository Size Limit:** The repository used for your GitHub Pages site has the same size recommendations as regular GitHub repositories (ideally under 1 GB).

*   **Site Size Limit:** The published GitHub Pages site itself (the files that are served to visitors) has a size limit of **1 GB**.

*   **Bandwidth Limit:** GitHub Pages sites have a soft bandwidth limit of **100 GB per month**.

*   **Build Time Limit:** GitHub Pages sites have a build time limit of **10 minutes**. If your site takes longer than 10 minutes to build, the build will fail.

*   **Enforcement:** GitHub may contact you if your GitHub Pages site is consuming excessive resources (e.g., exceeding the bandwidth limit).  In extreme cases, they may limit or suspend your site.

**Key Takeaways:**

*   **Repository Size:** Aim to keep your repositories under 1 GB. Use Git LFS for large files.
*   **GitHub Pages Site Size:** The published site must be under 1 GB.
*   **GitHub Pages Bandwidth:** 100 GB per month.

Anonymous

Space limits for GitHub repositories and GitHub Pages:29.03.26

Information Epoch 1775865235