Repository checks
Introduced in GitLab 8.7. It is OFF by default because it still causes too many false alarms.
Git has a built-in mechanism, 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 panel. The checks run asynchronously so it may take a few minutes before the check result is visible on the project admin page. If the checks failed you can see their output on the admin log page under ‘repocheck.log’.
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 will be checked no more than once per month. If any projects
fail their repository checks all GitLab administrators will 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 panel.
What to do if a check failed
If the repository check fails for some repository you should look up the error
in repocheck.log
:
- in the admin panel
- or on disk, see:
-
/var/log/gitlab/gitlab-rails
for Omnibus installations -
/home/git/gitlab/log
for installations from source
-
If for some reason the periodic repository check caused a lot of false
alarms you can choose to clear all repository check states by
clicking “Clear all repository checks” on the Settings page of the
admin panel (/admin/application_settings
).
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