"remaining connection slots are reserved": the 7 superuser slots

TL;DR

When every other slot is taken, regular roles get this instead of "too many clients already". Neon reserves 7 connections for its superuser account.

Steps

1. Neon reserves 7 connections for its superuser account. When every other slot is taken, regular roles get this instead of "too many clients already". It is the same exhaustion, one step later.
2. - Move app traffic to the pooled string; this is almost always a direct-connection workload that should not be direct.

• Audit for leaked or long-held direct connections (migrations left open, scripts, BI tools on direct).
• Raise compute size if the direct workload is legitimate.

When to use

You are seeing this: Neon reserves 7 connections for its superuser account. Use this skill when you run into ""remaining connection slots are reserved": the 7 superuser slots".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

Neon reserves 7 connections for its superuser account.

Neon's pooling docs (verified live 2026-09-26): 7 connections reserved for the Neon superuser; 0.25 CU example gives 97 available of 104 total; the connection error docs list this error among resolved connection errors.