# Troubleshooting Guide

Prisma cannot connect:
Check `DATABASE_URL`, URL-encoded password characters, database grants, and cPanel prefixes.

Camera scanner does not open:
Use HTTPS and grant browser camera permission.

Cron endpoint returns 401:
Check `CRON_SECRET` and the `x-cron-secret` header.

Uploads fail:
Check file extension, MIME validation, file size limits, and folder permissions.

Next.js build fails on Namecheap:
Confirm Node.js LTS version, install dependencies, run Prisma generate, and check environment variables.