Inactive project deletion
Introduced in GitLab 15.0 with a flag named
inactive_projects_deletion. Disabled by default.
inactive_projects_deletionremoved in GitLab 15.4.
- Configuration through GitLab UI introduced in GitLab 15.1.
Administrators of large GitLab instances can find that over time, projects become inactive and are no longer used. These projects take up unnecessary disk space.
With inactive project deletion, you can identify these projects, warn the maintainers ahead of time, and then delete the projects if they remain inactive. When an inactive project is deleted, the action generates an audit event that it was performed by the @GitLab-Admin-Bot.
For the default setting on GitLab.com, see the GitLab.com settings page.
Configure inactive project deletion
To configure deletion of inactive projects:
- On the top bar, select Main menu > Admin.
- On the left sidebar, select Settings > Repository.
- Expand Repository maintenance.
- In the Inactive project deletion section, select Delete inactive projects.
- Configure the settings.
- The warning email is sent to users who have the Owner and Maintainer role for the inactive project.
- The email duration must be less than the Delete project after duration.
- Select Save changes.
Inactive projects that meet the criteria are scheduled for deletion and a warning email is sent. If the projects remain inactive, they are deleted after the specified duration.
If you use these settings:
- Delete inactive projects enabled.
Delete inactive projects that exceed set to
Delete project after set to
Send warning email set to
If a project is less than 50 MB, the project is not considered inactive.
If a project is more than 50 MB and it is inactive for:
- More than 6 months: A deletion warning email is sent. This mail includes the date that the project will be deleted.
- More than 12 months: The project is scheduled for deletion.
Determine when a project was last active
You can view a project’s activities and determine when the project was last active in the following ways:
- Go to the activity page for the project and view the date of the latest event.
- View the
last_activity_atattribute for the project using the Projects API.
- List the visible events for the project using the Events API.
created_atattribute of the latest event.