SuiteCRM 7 includes built-in utilities to help you gather technical data before seeking external support.
The first step for almost any issue. It synchronises the database schema with the metadata files and clears the cached definitions. This is found under Admin > Repair.
Located in Admin > Diagnostic Tool. Use this to package your config.php, phpinfo, and database schema. This package is essential when requested by technical support to understand your environment without needing direct server access.
SuiteCRM Log: Viewable at the bottom of the Admin page or via the filesystem at /suitecrm.log.
PHP Error Logs: Usually managed by your web server (Apache/Nginx). These contain the technical details behind system crashes or "White Screen" errors.
When a system issue occurs in SuiteCRM 7, it is commonly related to one of three areas: Permissions, background processes (Cron), or Database/Metadata synchronisation. Use the guides below to diagnose and resolve common administrative issues.
Identify your symptom to find the relevant resolution guide.
| If you see… | Potential Cause | Immediate Action |
|---|---|---|
A "White Screen of Death" (WSOD) |
Fatal PHP Error or Permissions |
Check System Logs and run Quick Repair and Rebuild. |
Broken Layouts or missing CSS |
Cache/Permissions issues |
Verify File Permissions and run Quick Repair and Rebuild. |
Workflows/Campaigns not sending |
Scheduler or Cron failure |
Check Schedulers and your server’s Crontab. |
Missing Fields in the UI |
Metadata out of sync |
Run Quick Repair and Rebuild. |
Users not able to access new modules |
Roles not up to date |
Run Repair Roles. |
Database Errors after an update |
Table schema mismatch |
Run Quick Repair and Rebuild and scroll to the bottom to Execute changes. |
If the self-service steps above do not resolve the issue, you can leverage the following resources.
The official community forum is a vast knowledge base. When posting, always include your PHP version, SuiteCRM version, and relevant log entries.
Visit: SuiteCRM Community Forums
For guaranteed response times and expert support from the authors and maintainers, consider accessing official SuiteCRM support provided by SuiteCRM Ltd . These offer personalised guidance and reliable, ongoing technical expertise.
Visit: SuiteCRM Support Services
If you have identified a repeatable bug in the core code, please report it via the relevant official GitHub repository.
SuiteCRM 7 (Legacy/Hotfix): https://github.com/SuiteCRM/SuiteCRM/issues
Please do not use GitHub for general "How-to" questions; keep those for the community forums to ensure the developers can focus on code-level issues.
Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.