How to upload release zip file bigger than 2gb

[FamilFG]

🏷️ Discussion Type

Question

💬 Feature/Topic Area

Code Search and Navigation

Body

I have a zip file of my project which is 2.8gb, how do i upload it to a release

[ushxyuki]

GitHub Releases cannot upload one asset that is 2.8 GB because the per-file release asset limit is 2 GB. You need to either split the zip into smaller parts, for example project.part1.zip and project.part2.zip, and upload them separately, or upload the full file to another storage service like Google Drive, OneDrive, or S3 and place the download link in the release notes. Git LFS can also work for some large files, but it has storage and bandwidth limits, so it may not be ideal for a 2.8 GB release file.

[Maazitm]

Option 1: Split the archive (Keeps it native on GitHub)
You can use a compression tool to split your zip file into multiple smaller volumes (e.g., 1.4 GB each).

If you use 7-Zip (Windows) or Keka (Mac), you can easily split it into project.zip.001 and project.zip.002.

Upload both parts to the release. When someone downloads them, they just need to extract the first file, and the software will stitch them back together automatically.

Option 2: Cloud storage (Easiest and fastest)
Upload your 2.8 GB file to a reliable cloud provider (like Google Drive, OneDrive, AWS S3, or Mega). Generate a shareable, public download link and paste that directly into the description body of your GitHub Release.