diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md index 313dbfc14e4e76a93914f07a9df47c7ecf7e3092_ZG9jL3Ryb3VibGVzaG9vdGluZy5tZA==..5feb9a44ccba152d625efe39ac5ceacc9125d906_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