🔧
Troubleshooting
Common issues and how to fix them.
Pages are not loading after deployment
Common causes of pages not loading after deploying Underpeaks.
My install is stuck — what do I do?
What to do if the Underpeaks installer gets stuck.
Why is my generated app not connecting to my Underpeaks instance?
Check embedded API URL (Flutter) or NXF_ env vars (Next.js).
Why are my API requests returning 401 Unauthorized?
Usually a missing, invalid, or mismatched-project API key.
Why does my delete request silently do nothing?
Core's Delete endpoint only matches on the id column — a known limitation.
What do I do if the CLI login isn't opening a browser?
nxf login prints a URL to open manually if your browser doesn't launch automatically.