Troubleshooting a GitLab installation All tiers Self-managed

This page documents a collection of resources to help you troubleshoot a GitLab installation.

This list is not necessarily comprehensive. If you don’t find what you’re looking for in this list, you should search the documentation.

Troubleshooting guides

Some feature documentation pages also have a troubleshooting section at the end that you can check for feature-specific help, including helpful Rails commands.

If you need a testing environment to troubleshoot, see the apps for a testing environment.

Support team troubleshooting info

The GitLab Support Team has collected a lot of information about troubleshooting GitLab. The following documents are used by the Support Team or by customers with direct guidance from a Support Team member. GitLab administrators may find the information useful for troubleshooting. However, if you are experiencing trouble with your GitLab instance, you should check your support options before referring to these documents.

caution
The commands in the following documentation might result in data loss or other damage to a GitLab instance. They should be used only by experienced administrators who are aware of the risks.