Account and limit settings
Repository size limit
Repositories within your GitLab instance can grow quickly, especially if you are using LFS. Their size can grow exponentially and eat up your storage device quite fast.
In order to avoid this from happening, you can set a hard limit for your repositories’ size. This limit can be set globally, per group, or per project, with per project limits taking the highest priority.
There are numerous cases where you’ll need to set up a limit for repository size. For instance, consider the following workflow:
- Your team develops apps which demand large files to be stored in the application repository.
- Although you have enabled Git LFS to your project, your storage has grown significantly.
- Before you blow your storage limit up, you set up a limit of 10 GB per repository.
How it works
Only a GitLab administrator can set those limits. Setting the limit to 0
means
there are no restrictions.
These settings can be found within:
- Each project’s settings.
- A group’s settings.
- The Size limit per repository (MB) field in the Account and limit section of a GitLab instance’s
settings by navigating to either:
- Admin Area > Settings > General.
- The path
/admin/application_settings
.
The very first push of a new project cannot be checked for size as of now, so the first push will allow you to upload more than the limit dictates, but every subsequent push will be denied. LFS objects, however, can be checked on first push and will be rejected if the sum of their sizes exceeds the maximum allowed repository size.
For more manually purging the files, read the docs on reducing the repository size using Git.
Note: For GitLab.com, the repository size limit is 10 GB.
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc