Skip to main content

System Health

Super Admin โ†’ System Health provides a real-time overview of the platform's operational status.


Opening System Healthโ€‹

Go to Super Admin โ†’ System Health in the super admin sidebar.


Health Checksโ€‹

The System Health page shows pass/fail status for each diagnostic check:

CheckWhat It Verifies
Queue StatusWhether the cron job is running and processing jobs
Database ConnectionWhether the database is reachable
Storage WritableWhether the storage/ directory is writable
Cache WritableWhether the cache directory is writable
PHP VersionWhether PHP meets the minimum version requirement
Required ExtensionsWhether all required PHP extensions are loaded
Mail ConfigurationWhether SMTP is configured
License ValidWhether the platform license key is active

Queue Statusโ€‹

The most important check is the Queue Status. It shows:

  • Green (Running): The cron job has run within the last 5 minutes. Queue jobs are processing normally.
  • Yellow (Slow): The cron job last ran more than 5 minutes ago. Automations and emails may be delayed.
  • Red (Stopped): The cron job has not run for 10+ minutes. Automations, emails, and scheduled tasks are not processing.

If the queue status is red or yellow:

  1. Log in to your hosting control panel.
  2. Go to Cron Jobs and verify the cron command is present and correct.
  3. Check the path to cron.php โ€” it must be the full absolute path.
  4. Run the cron command manually to test it.

Storage Informationโ€‹

Shows:

  • Total disk space
  • Used disk space
  • Available disk space
  • Storage path

PHP Informationโ€‹

Shows:

  • Current PHP version
  • Memory limit
  • Max execution time
  • Loaded extensions

Tenant Statisticsโ€‹

A summary of:

  • Total tenants
  • Active tenants
  • Total leads across all tenants
  • Total users across all tenants

Refreshingโ€‹

Click Refresh to re-run all health checks. The page also auto-refreshes every 60 seconds.


What to Do When Checks Failโ€‹

Failing CheckAction
Queue StoppedRe-verify cron job in hosting panel
Storage Not WritableSet storage/ permissions to 755 (see Shared Hosting Guide)
PHP Version Too LowUpgrade PHP via MultiPHP Manager in cPanel
Missing ExtensionEnable the extension via cPanel PHP Extensions
License InvalidRe-enter license key in Super Admin โ†’ Settings โ†’ License