gitlab-org--gitlab-foss/doc/administration/repository_checks.md

---
stage: Create
group: Editor
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
type: reference
---

# Repository checks

> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/3232) in GitLab 8.7.

Git has a built-in mechanism, [`git fsck`](https://git-scm.com/docs/git-fsck), to verify the
integrity of all data committed to a repository. GitLab administrators
can trigger such a check for a project via the project page under the
Admin Area. The checks run asynchronously so it may take a few minutes
before the check result is visible on the project Admin Area. If the
checks failed you can see their output on in the
[`repocheck.log` file.](logs.md#repochecklog)

This setting is off by default, because it can cause many false alarms.

## Periodic checks

When enabled, GitLab periodically runs a repository check on all project
repositories and wiki repositories in order to detect data corruption.
A project is checked no more than once per month. If any projects
fail their repository checks all GitLab administrators receive an email
notification of the situation. This notification is sent out once a week,
by default, midnight at the start of Sunday. Repositories with known check
failures can be found at `/admin/projects?last_repository_check_failed=1`.

## Disabling periodic checks

You can disable the periodic checks on the **Settings** page of the Admin Area.

## What to do if a check failed

If the repository check fails for some repository you should look up the error
in the [`repocheck.log` file](logs.md#repochecklog) on disk:

- `/var/log/gitlab/gitlab-rails` for Omnibus GitLab installations
- `/home/git/gitlab/log` for installations from source

If the periodic repository check causes false alarms, you can clear all repository check states by
going to **Admin Area > Settings > Repository**
(`/admin/application_settings/repository`) and clicking **Clear all repository checks**.
Add latest changes from gitlab-org/gitlab@master 2020-07-30 12:09:33 +00:00			`---`
			`stage: Create`
			`group: Editor`
Add latest changes from gitlab-org/gitlab@master 2020-11-26 06:09:20 +00:00			`info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"`
Add latest changes from gitlab-org/gitlab@master 2020-07-30 12:09:33 +00:00			`type: reference`
			`---`

Rename almost all the things 2016-04-06 11:47:05 +00:00			`# Repository checks`
Rebase repo check MR 2016-04-04 15:23:43 +00:00
Add latest changes from gitlab-org/gitlab@master 2020-04-21 15:21:10 +00:00			`> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/3232) in GitLab 8.7.`
Rebase repo check MR 2016-04-04 15:23:43 +00:00
Add latest changes from gitlab-org/gitlab@master 2020-04-21 15:21:10 +00:00			Git has a built-in mechanism, [`git fsck`](https://git-scm.com/docs/git-fsck), to verify the
commited -> committed 2016-05-30 05:30:16 +00:00			`integrity of all data committed to a repository. GitLab administrators`
Move 'clear checks' button to applicatoin settings 2016-04-12 15:32:58 +00:00			`can trigger such a check for a project via the project page under the`
Add latest changes from gitlab-org/gitlab@master 2021-02-16 00:09:01 +00:00			`Admin Area. The checks run asynchronously so it may take a few minutes`
			`before the check result is visible on the project Admin Area. If the`
Add latest changes from gitlab-org/gitlab@master 2021-01-28 00:09:33 +00:00			`checks failed you can see their output on in the`
			[`repocheck.log` file.](logs.md#repochecklog)
Rebase repo check MR 2016-04-04 15:23:43 +00:00
Add latest changes from gitlab-org/gitlab@master 2021-01-28 00:09:33 +00:00			`This setting is off by default, because it can cause many false alarms.`
Add latest changes from gitlab-org/gitlab@master 2020-03-24 03:09:28 +00:00
Improve English, thanks Robert 2016-04-13 09:15:36 +00:00			`## Periodic checks`
Rebase repo check MR 2016-04-04 15:23:43 +00:00
Small documentation reformatting and updates 2018-04-23 14:33:18 +00:00			`When enabled, GitLab periodically runs a repository check on all project`
Add small improvements to the docs 2018-05-03 19:14:48 +00:00			`repositories and wiki repositories in order to detect data corruption.`
Add latest changes from gitlab-org/gitlab@master 2021-01-28 00:09:33 +00:00			`A project is checked no more than once per month. If any projects`
			`fail their repository checks all GitLab administrators receive an email`
Add small improvements to the docs 2018-05-03 19:14:48 +00:00			`notification of the situation. This notification is sent out once a week,`
docs: link to repo check failures 2018-09-20 09:10:57 +00:00			`by default, midnight at the start of Sunday. Repositories with known check`
			failures can be found at `/admin/projects?last_repository_check_failed=1`.
Rebase repo check MR 2016-04-04 15:23:43 +00:00
Document how to disable repo checks 2016-04-06 10:26:29 +00:00			`## Disabling periodic checks`

Add latest changes from gitlab-org/gitlab@master 2021-02-16 00:09:01 +00:00			`You can disable the periodic checks on the Settings page of the Admin Area.`
Rebase repo check MR 2016-04-04 15:23:43 +00:00
			`## What to do if a check failed`

Remove \f. WT\F ?? 2016-04-13 10:20:43 +00:00			`If the repository check fails for some repository you should look up the error`
Add latest changes from gitlab-org/gitlab@master 2020-05-15 00:08:06 +00:00			in the [`repocheck.log` file](logs.md#repochecklog) on disk:
Small documentation reformatting and updates 2018-04-23 14:33:18 +00:00
Add latest changes from gitlab-org/gitlab@master 2021-01-28 00:09:33 +00:00			- `/var/log/gitlab/gitlab-rails` for Omnibus GitLab installations
Add latest changes from gitlab-org/gitlab@master 2020-05-15 00:08:06 +00:00			- `/home/git/gitlab/log` for installations from source
Small documentation reformatting and updates 2018-04-23 14:33:18 +00:00
Add latest changes from gitlab-org/gitlab@master 2019-12-19 06:08:05 +00:00			`If the periodic repository check causes false alarms, you can clear all repository check states by`
Add latest changes from gitlab-org/gitlab@master 2021-01-28 00:09:33 +00:00			`going to Admin Area > Settings > Repository`
Add latest changes from gitlab-org/gitlab@master 2019-12-19 06:08:05 +00:00			(`/admin/application_settings/repository`) and clicking Clear all repository checks.