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