Database

Supavisor

Troubleshooting Supavisor errors


Supavisor logs are available under Pooler Logs in the Dashboard. The following are common errors and their solutions:

Error TypeDescriptionResolution Link
Max client connections reachedThis error happens when the number of connections to Supavisor is more than the allowed limit of your compute add-on.Follow this guide to resolve.
Connection failed {:error, :eaddrnotavail} to 'db.xxx.supabase.co':5432Supavisor cannot connect to the customer database. This is usually caused if the target database is unable to respond.N/A
Connection failed {:error, :nxdomain} to 'db.xxx.supabase.co':5432Supavisor cannot connect to the customer database. This is usually caused if the target database is unable to respond.N/A
Connection closed when state was authenticationThis error happens when either the database doesn’t exist or if the user doesn't have the right credentials.N/A
Subscribe error: {:error, :worker_not_found}This log event is emitted when the client tries to connect to the database, but Supavisor does not have the necessary information to route the connection. Try reconnecting to the database as it can take some time for the project information to propagate to Supavisor.N/A
Subscribe error: {:error, {:badrpc, {:error, {:erpc, :timeout}}}}This is a timeout error when the communication between different Supavisor nodes takes longer than expected. Try reconnecting to the database.N/A
Terminating with reason :client_termination when state was :busyThis error happens when the client terminates the connection before the connection with the database is completed.N/A