System & Console ID: plg_system_safemode
A critical safety net to recover your site from fatal errors and white screens.
Why use SafeMode?
Emergency Recovery
Regain access when the administrator panel is inaccessible due to extension conflicts or fatal errors.
Safe Troubleshooting
Disable problematic plugins or templates while keeping core Joomla functions intact for diagnosis.
Console Usage (CLI)
1 Access your server via SSH or command line interface.
2 Navigate to your Joomla root directory.
3 Run the following command to enable SafeMode:
php cli/joomla.php safemode:enable4 This enters a protected state where only core Joomla functions run.
5 Once the problematic extension is identified and fixed, disable SafeMode with:
php cli/joomla.php safemode:disable Important: SafeMode is designed for emergency recovery only. Always maintain regular backups and test extensions on a staging environment before deploying to production.
Resources & Links
Requirements:
Joomla 5.0 or higher
PHP 8.1 or higher
Command-line access (SSH) required