System Health

Paymery includes a built-in System Health page in the admin panel. This page provides a quick overview of the application's configuration and runtime checks, helping admins identify missing requirements, misconfigured services, or production issues.

Where to Find System Health

Navigate to Admin → System Health to view the current health status of your installation.

What System Health Checks

System Health is grouped into sections. Each section reports whether your configuration is ready, and highlights what needs to be fixed if something is missing.

1) Environment

This section shows environment-related information and checks, such as whether the application is running in the recommended mode for production.

• Application environment (example: production / local)
• Debug mode status
• Base URL configuration (when relevant)

2) Database & Cache

This section confirms database connectivity and cache configuration. It helps detect issues such as invalid DB credentials or missing cache setup.

• Database connection status
• Cache driver status (file / database / redis)
• Configuration readiness for production use

3) Queue

Background jobs require a queue worker. System Health helps you verify that queue processing is configured.

• Queue driver (sync / database / redis)
• Whether queue processing is expected
• Guidance if workers are not running

If queue is not running, emails and background tasks may not be processed. See Cron & Queue.

4) Mail

This section checks mail configuration so password resets, notifications, and billing-related emails can be delivered.

• Mail driver configuration
• SMTP settings readiness
• Ability to send test emails (when available)

For full mail template customization, see Email Templates.

5) Storage

Storage checks ensure the application can write logs, cache, and uploaded files. This is one of the most common causes of 500 errors after deployment.

• Writable permissions for storage
• Writable permissions for bootstrap/cache
• Uploads readiness (when applicable)

6) Billing

Billing checks help confirm whether your selected billing mode is configured correctly:

• Billing mode (Manual or Stripe/Cashier)
• Stripe keys presence (if Stripe is enabled)
• Webhook endpoint visibility (if Stripe is enabled)

Stripe setup is covered in detail here: Stripe Configuration.

How to Use System Health

1. Open Admin → System Health
2. Review each section for warnings or missing configuration
3. Fix the highlighted items (database credentials, mail settings, cron/queue setup, etc.)
4. Refresh the page to confirm the system is healthy

Notes

• System Health is a diagnostic tool that helps reduce deployment mistakes and support requests.
• Always review System Health after switching billing mode, changing currency, or updating environment settings.
• If everything is healthy but you still see issues, check server logs for more details.