Troubleshooting

Common Simulacrum CLI and generated-app issues with concrete fixes.

CLI activation fails

Confirm outbound HTTPS, paste the full license key without spaces, and run simulate status after simulate activate.

Database connection errors

Verify DATABASE_URL, pooling mode, and IP allowlists on your host. See Database overview.

Auth redirect loops

Check cookie domains, BETTER_AUTH_URL, and HTTPS mismatches between local and production.

Webhooks not firing

Rotate secrets, confirm public URLs are reachable, and inspect provider dashboards for delivery errors.

Build failures

Run npm run lint and npx tsc --noEmit. Compare Node versions between local and CI.

Related guides

• Local development
• Deployment on Vercel