diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md index 0fd54face162d9de59d57c13fc980beda334576a_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA==..4a978ca7b82e0fa0353e759820c5dbd9f3a133d3_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA== 100644 --- a/doc/troubleshooting.md +++ b/doc/troubleshooting.md @@ -248,6 +248,30 @@ Run `sudo gitlab-ctl reconfigure` for the change to take effect. +## PostgreSQL error `FATAL: remaining connection slots are reserved for non-replication superuser connections` + +PostgreSQL has a setting for the maximum number of the concurrent connections +to the database server. If you see this error, it means that your GitLab instance is trying to exceed +this limit on the number of concurrent connections. + +To fix this problem, you have two options: + +- Either increase the max connections value: + + 1. Edit `/etc/gitlab/gitlab.rb`: + + ```ruby + postgresql['max_connections'] = 600 + ``` + + 1. Reconfigure GitLab: + + ```shell + sudo gitlab-ctl reconfigure + ``` + +- Or, you can consider [using PgBouncer](https://docs.gitlab.com/ee/administration/postgresql/pgbouncer.html) which is a connection pooler for PostgreSQL. + ## Reconfigure complains about the GLIBC version ```shell