Troubleshooting

My install is stuck — what do I do?

What to do if the Underpeaks installer gets stuck.

Pages are not loading after deployment

Common causes of pages not loading after deploying Underpeaks.

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.