Common issues

License key rejected

• Keys are product-bound. An entrytwo key will not activate Invoices.
• Buy or issue with product: invoices. Master support key still works for both.

HTTPS / SSL errors

• DNS A record must point at the VPS before ACME. Restart reverse proxy after late DNS.

Docker migrate: datasource.url required

• Image must include prisma.config.ts. Rebuild from current Dockerfile. Runtime needs DATABASE_URL.

Invoice emails stuck PENDING

• Start the worker compose service (npm run worker locally).

Auth not production-ready

• Need strong AUTH_SECRET, public AUTH_URL, AUTH_TRUST_HOST=true, and SMTP and/or OAuth.

More detail: github.com/felixkrusch/invoices docs/.