Troubleshooting "Max client connections reached" error for Supabase connections

Last updated: August 15, 2025

If you're encountering a "Max client connections reached" error even when your database shows plenty of available connections, the issue may be related to user-specific connection limits rather than overall database limits.

Check User-Specific Connection Limits

The most common cause of this error is that the specific database user used by Explo has reached its individual connection limit, even though the database itself has capacity for more connections.

To resolve this issue:

  1. Identify the database user that Explo is using to connect (you can find this on the data tab by editing a specific connection)

  2. Check if there are connection limits set specifically for that user in the Supabase console

  3. If user-specific limits exist, consider increasing them or removing the restriction for the Explo user