2021-01-29 00:20:46 +05:30
---
2022-07-23 23:45:48 +05:30
stage: Systems
2021-02-22 17:27:13 +05:30
group: Distribution
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2021-09-04 01:27:46 +05:30
# Troubleshooting a GitLab installation **(FREE SELF)**
2020-06-23 00:09:42 +05:30
2021-04-29 21:17:54 +05:30
This page documents a collection of resources to help you troubleshoot a GitLab
installation.
2020-06-23 00:09:42 +05:30
2023-01-13 00:05:48 +05:30
This list is not necessarily comprehensive. If you don't find what you're looking
for in this list, you should search the documentation.
2021-04-29 21:17:54 +05:30
## Troubleshooting guides
- [SSL ](ssl.md )
- [Geo ](../geo/replication/troubleshooting.md )
2023-01-13 00:05:48 +05:30
- [SAML ](../../user/group/saml_sso/troubleshooting.md )
2022-08-13 15:12:31 +05:30
- [Kubernetes cheat sheet ](https://docs.gitlab.com/charts/troubleshooting/kubernetes_cheat_sheet.html )
2020-06-23 00:09:42 +05:30
- [Linux cheat sheet ](linux_cheat_sheet.md )
2022-08-27 11:52:29 +05:30
- [Parsing GitLab logs with `jq` ](../logs/log_parsing.md )
2021-04-29 21:17:54 +05:30
- [Diagnostics tools ](diagnostics_tools.md )
2020-06-23 00:09:42 +05:30
2022-08-13 15:12:31 +05:30
Some feature documentation pages also have a troubleshooting section at the end
2023-01-13 00:05:48 +05:30
that you can check for feature-specific help, including helpful Rails commands.
2022-08-13 15:12:31 +05:30
2020-06-23 00:09:42 +05:30
If you need a testing environment to troubleshoot, see the
[apps for a testing environment ](test_environments.md ).
2023-06-20 00:43:36 +05:30
## 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 ](https://about.gitlab.com/support/ )
before referring to these documents.
WARNING:
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.
- [Diagnostics tools ](diagnostics_tools.md )
- [Linux commands ](linux_cheat_sheet.md )
- [Troubleshooting Kubernetes ](https://docs.gitlab.com/charts/troubleshooting/kubernetes_cheat_sheet.html )
- [Troubleshooting PostgreSQL ](postgresql.md )
- [Guide to test environments ](test_environments.md ) (for Support Engineers)
- [Troubleshooting SSL ](ssl.md )
- Related links:
- [Repairing and recovering broken Git repositories ](https://git.seveas.net/repairing-and-recovering-broken-git-repositories.html )
- [Testing with OpenSSL ](https://www.feistyduck.com/library/openssl-cookbook/online/testing-with-openssl/index.html )
- [`strace` zine ](https://wizardzines.com/zines/strace/ )
