Storage usage quota (FREE)

  • Introduced in GitLab 12.0.
  • Moved to GitLab Free.

Namespace storage limit

Namespaces on a GitLab SaaS Free tier have a 5 GB storage limit. For more information, see our pricing page. This limit is not visible on the storage quota page, but we plan to make it visible and enforced starting October 19, 2022.

Storage types that add to the total namespace storage are:

  • Git repository
  • Git LFS
  • Artifacts
  • Container registry
  • Package registry
  • Dependecy proxy
  • Wiki
  • Snippets

If your total namespace storage exceeds the available namespace storage quota, all projects under the namespace are locked. A locked project will not be able to push to the repository, run pipelines and jobs, or build and push packages.

To prevent exceeding the namespace storage quota, you can:

  1. Purchase more storage.
  2. Upgrade to a paid tier.
  3. Reduce storage usage.

Namespace storage limit enforcement schedule

Starting October 19, 2022, a storage limit will be enforced on all GitLab Free namespaces. We will start with a large limit enforcement and eventually reduce it to 5 GB.

The following table describes the enforcement schedule, which is subject to change.

Target enforcement date Limit Expected Impact Status
October 19, 2022 45,000 GB LOW Pending ({hourglass})
October 20, 2022 7,500 GB LOW Pending ({hourglass})
October 24, 2022 500 GB MEDIUM Pending ({hourglass})
October 27, 2022 75 GB MEDIUM HIGH Pending ({hourglass})
November 2, 2022 10 GB HIGH Pending ({hourglass})
November 9, 2022 5 GB VERY HIGH Pending ({hourglass})

Namespaces that reach the enforced limit will have their projects locked. To unlock your project, you will have to manage its storage.

Project storage limit

Namespaces on a GitLab SaaS paid tier (Premium and Ultimate) have a storage limit on their project repositories. A project's repository has a storage quota of 10 GB. A namespace has either a namespace-level storage limit or a project-level storage limit, but not both.

  • Paid tier namespaces have project-level storage limits enforced.
  • Free tier namespaces have namespace-level storage limits.

When a project's repository reaches the quota, the project is locked. You cannot push changes to a locked project. To monitor the size of each repository in a namespace, including a breakdown for each project, you can view storage usage. To allow a project's repository to exceed the free quota you must purchase additional storage. For more details, see Excess storage usage.

View storage usage

You can view storage usage for your project or namespace.

  1. Go to your project or namespace:
    • For a project, on the top bar, select Menu > Projects and find your project.
    • For a namespace, enter the URL in your browser's toolbar.
  2. From the left sidebar, select Settings > Usage Quotas.
  3. Select the Storage tab.

The statistics are displayed. Select any title to view details. The information on this page is updated every 90 minutes.

If your namespace shows 'Not applicable.', push a commit to any project in the namespace to recalculate the storage.

Storage usage statistics

  • Introduced project-level graph in GitLab 14.4 with a flag named project_storage_ui. Disabled by default.
  • Enabled on in GitLab 14.4.
  • Enabled on self-managed in GitLab 14.5.
  • Feature flag removed in GitLab 14.5.

The following storage usage statistics are available to a maintainer:

  • Total namespace storage used: Total amount of storage used across projects in this namespace.
  • Total excess storage used: Total amount of storage used that exceeds their allocated storage.
  • Purchased storage available: Total storage that has been purchased but is not yet used.

Manage your storage usage

You can use several methods to manage and reduce your usage for some storage types.

For more information, see the following pages:

Excess storage usage

Excess storage usage is the amount that a project's repository exceeds the free storage quota. If no purchased storage is available the project is locked. You cannot push changes to a locked project. To unlock a project you must purchase more storage for the namespace. When the purchase is completed, locked projects are automatically unlocked. The amount of purchased storage available must always be greater than zero.

The Storage tab of the Usage Quotas page warns you of the following:

  • Purchased storage available is running low.
  • Projects that are at risk of being locked if purchased storage available is zero.
  • Projects that are locked because purchased storage available is zero. Locked projects are marked with an information icon ({information-o}) beside their name.

Excess storage example

The following example describes an excess storage scenario for namespace Example Company:

Repository Storage used Excess storage Quota Status
Red 10 GB 0 GB 10 GB Locked {lock}
Blue 8 GB 0 GB 10 GB Not locked
Green 10 GB 0 GB 10 GB Locked {lock}
Yellow 2 GB 0 GB 10 GB Not locked
Totals 30 GB 0 GB - -

The Red and Green projects are locked because their repositories have reached the quota. In this example, no additional storage has yet been purchased.

To unlock the Red and Green projects, 50 GB additional storage is purchased.

Assuming the Green and Red projects' repositories grow past the 10 GB quota, the purchased storage available decreases. All projects remain unlocked because 40 GB purchased storage is available: 50 GB (purchased storage) - 10 GB (total excess storage used).

Repository Storage used Excess storage Quota Status
Red 15 GB 5 GB 10 GB Not locked
Blue 14 GB 4 GB 10 GB Not locked
Green 11 GB 1 GB 10 GB Not locked
Yellow 5 GB 0 GB 10 GB Not locked
Totals 45 GB 10 GB - -