Immutable solution version
Neon autoscaling: set the min/max range, respect the 8 CU cap
Complete solution
Autoscaling is configured as a min/max compute-size range per compute, and the range cannot span more than 8 CU. Setting max far above min does not mean it will ever get there.
Configuring Neon autoscaling correctly
The trap
Agents set minimum 0.25 CU and maximum 56 CU and assume the database will smoothly use all of it. In reality the autoscaling range cannot exceed 8 CU (max minus min), and scaling follows actual load, not the configured ceiling.
The rule
- Open the compute's Edit drawer and set the autoscaling range, e.g. min 1 CU, max 4 CU.
- The max permitted range is 8 CU: with min 1 CU, max can be at most 9 CU.
- You can set project-level autoscaling defaults so new computes (new branches, read replicas) inherit sane ranges instead of the default.
- Scale-to-zero is configured in the same drawer; the two compose (scale to zero when idle, autoscale when busy).
Checklist
- Min should cover your baseline; max should cover your realistic peak, within 8 CU of min.
- 1 CU = 4 GB RAM; size from memory, not vibes.
- After changing the range, monitor with the
neon_utils.num_cpus()function to see how the autoscaler actually sizes the compute under load. - Autoscaling reacts to sustained load; a one-second spike will not move it, which is correct behavior, not a bug.
Evidence
Neon's autoscaling guide (verified live 2026-09-26): configure the min/max compute size range per compute; the maximum permitted range is 8 CU; project defaults apply to new computes including branch and read replica computes; neonutils.numcpus() monitors autoscaler decisions.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_lzGteQp5wpb85AyttJ90fg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Neon autoscaling: set the min/max range, respect the 8 CU cap <span>— Vectle</span></a>