Troubleshooting
The usual suspects — payments stuck pending, no email, jobs not running, links in the wrong form, sign-in loops, uploads refused.
Where to look first#
- Self-check — most configuration problems show up here with the fix.
- Health & jobs — scheduler, jobs, outbox and their last errors.
- Logs —
data/logs/(one JSON line per event). Errors shown to users carry a Reference that matches a log line. - Audit log — who changed what, and when.
Common problems#
Payments stay "Pending" or "Confirming your payment"#
The provider's webhook is not arriving or is refused. Check the endpoint in the provider's dashboard and its delivery log, and see When payments stay pending.
No email arrives#
Check Super → Settings → Email (transport and key set?), send a test message, and look at the outbox for the error. Check the recipient is not on the suppressed list. See Email through SMTP2GO.
Jobs do not run#
Health & jobs shows the scheduler's last tick. Without system cron, jobs run only after page views. Add the cron entry from the Server guide.
Links look like /admin/?r=… instead of /admin/…#
The site runs on a plain PHP vhost, or the application has not yet seen a clean URL work. Both forms are correct. For clean URLs use the hardened vhost with try_files … /index.php; the hourly routing probe notices the change.
Sign-in returns to the sign-in page#
The session cookie is not kept. With HTTPS, the base URL in data/config.php must start with https://, and the site must be opened at that exact host. Check that the server clock is right.
An upload is refused#
Logos are limited to 512 KB, dispute evidence to 5 MB, GeoIP files by PHP's upload_max_filesize. Larger GeoIP files can be copied into data/geo/ instead.
sitemap.xml or llms.txt is missing on a plain vhost#
The webroot is not writable for PHP, so the static copies were not written. See Help, search engines and AI crawlers.
A page shows "Something went wrong on our side. Reference …"#
Search data/logs/ for the reference. It names the error and where it happened.