Read-only namespaces and projects
Read-only namespaces
- Tier: Free
- Offering: GitLab.com
A namespace is placed in a read-only state when it exceeds the free user limit, and when the namespace visibility is private.
To remove the read-only state of a namespace and its projects, you can:
- Reduce the number of members in your namespace.
- Start a free trial, which includes an unlimited number of members.
- Purchase a paid tier.
Restricted actions
When a namespace is in a read-only state, you cannot execute the actions listed in the following table.
If you try to execute a restricted action, you might get a 404 error.
| Feature | Action restricted |
|---|---|
| Container registry | Create, edit, and delete cleanup policies. Push an image to the container registry. |
| Merge requests | Create and update a merge request. |
| Package registry | Publish a package. |
| CI/CD | Create, edit, administer, and run pipelines. Create, edit, administer, and run builds. Create and edit admin environments. Create and edit admin deployments. Create and edit admin clusters. Create and edit admin releases. |
| Namespaces | For exceeded free user limits: Invite new users. |
Read-only projects
- Tier: Free, Premium, Ultimate
A project is placed in a read-only state when it exceeds the allocated storage limit on the:
- Free tier, when any project in the namespace is over the free limit.
- Premium and Ultimate tiers, when any project in the namespace is over the fixed project limit.
Restricted actions
When a project is read-only due to storage limits, you can’t push or add large files (LFS) to the project’s repository. A banner at the top of the project or namespace page indicates the read-only status.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support
