{"id":8539,"date":"2026-05-25T10:36:29","date_gmt":"2026-05-25T08:36:29","guid":{"rendered":"https:\/\/mybox.com\/help\/?post_type=manual_kb&#038;p=8539"},"modified":"2026-06-25T11:08:53","modified_gmt":"2026-06-25T09:08:53","slug":"how-to-enable-debug-mode-in-joomla-cms-troubleshooting-site-errors","status":"publish","type":"manual_kb","link":"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-joomla-cms-troubleshooting-site-errors\/","title":{"rendered":"How to Enable Debug Mode in Joomla CMS: Troubleshooting Site Errors"},"content":{"rendered":"\n<div class=\"translation-block translation-block-merged\">\n<p class=\"wp-block-paragraph\">When developing custom extensions, applying templates, or managing upgrades on a <strong>Joomla CMS<\/strong> portal, unexpected software conflicts can occur. A site might suddenly exhibit an empty screen (commonly known as a &#8220;White Screen of Death&#8221;) or fail to render layout components properly following a system update.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">By default, Joomla suppresses detailed code warnings from public view to protect infrastructure parameters from bad actors. To identify and resolve database loops, broken class overrides, or script anomalies, you must temporarily activate Joomla&#8217;s internal diagnostic features. Enabling <strong>Debug Mode<\/strong> and adjusting your framework&#8217;s error tracking settings exposes the underlying error paths, allowing you to resolve issues efficiently.<\/p>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_86 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-joomla-cms-troubleshooting-site-errors\/#Method_1_Enabling_Debug_Mode_via_the_Administrative_Panel\" >Method 1: Enabling Debug Mode via the Administrative Panel<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-joomla-cms-troubleshooting-site-errors\/#Method_2_Enabling_Debug_Mode_via_the_configurationphp_File\" >Method 2: Enabling Debug Mode via the configuration.php File<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-joomla-cms-troubleshooting-site-errors\/#Interpreting_the_Debug_Output_Matrix\" >Interpreting the Debug Output Matrix<\/a><\/li><\/ul><\/nav><\/div>\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Method_1_Enabling_Debug_Mode_via_the_Administrative_Panel\"><\/span>Method 1: Enabling Debug Mode via the Administrative Panel<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<\/div>\n\n<div id=\"mybox-2965233037\" class=\"mybox-content mybox-entity-placement\"><div class=\"early-access-banner-inpost\">\r\n  <div class=\"banner-left-inpost\">\r\n    <div class=\"icon-box-inpost\">\r\n      <img decoding=\"async\" src=\"https:\/\/mybox.com\/help\/wp-content\/uploads\/2026\/02\/square-info-icon.svg\" alt=\"Info\">\r\n    <\/div>\r\n    <div class=\"text-box-inpost\">\r\n      <span class=\"label-inpost\"><span class=\"translation-block translation-block-banner-text\">Early access<\/span><\/span>\r\n      <h4><span class=\"translation-block translation-block-banner-text\">Still need help?<\/span><\/h4>\r\n      <p><span class=\"translation-block translation-block-banner-text\">Contact our customer service team.<\/span><\/p>\r\n    <\/div>\r\n  <\/div>\r\n\r\n  <div class=\"banner-right-inpost\">\r\n    <a href=\"https:\/\/panel.mybox.com\/helpdesk2\/v\/list\/\" class=\"banner-button-inpost\"><span class=\"translation-block translation-block-banner-text\">Message us<\/span><\/a>\r\n  <\/div>\r\n<\/div><\/div>\n\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">If your Joomla backoffice remains accessible, you can activate system diagnostics safely through the graphical administration dashboard without modifying configuration files manually.<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Log into your Joomla Administrator panel.<\/li>\n\n\n\n<li>Navigate to the global setup options:\n<ul class=\"wp-block-list\">\n<li>In <strong>Joomla 4 and Joomla 5<\/strong>: Select <strong>System<\/strong> from the main navigation sidebar, then click on <strong>Global Configuration<\/strong>.<\/li>\n\n\n\n<li>In <strong>Joomla 3<\/strong>: Select <strong>System<\/strong> from the top menu rail, then click on <strong>Global Configuration<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Click on the <strong>System<\/strong> tab located across the top configuration selection row.<\/li>\n\n\n\n<li>Locate the configuration setting labeled <strong>Debug System<\/strong> and switch the parameter toggle from <em>No<\/em> to <strong>Yes<\/strong>.<\/li>\n\n\n\n<li>Next, to see detailed error traces alongside system logs, click over to the <strong>Server<\/strong> tab.<\/li>\n\n\n\n<li>Locate the parameter block labeled <strong>Error Reporting<\/strong>. Switch this option from <em>System Default<\/em> to <strong>Maximum<\/strong> or <strong>Development<\/strong>.<\/li>\n\n\n\n<li>Click the <strong>Save &amp; Close<\/strong> button in the upper toolbar area to apply your new settings instantly.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Method_2_Enabling_Debug_Mode_via_the_configurationphp_File\"><\/span>Method 2: Enabling Debug Mode via the configuration.php File<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If a fatal script exception completely blocks access to your administrator dashboard, you cannot use the backend configuration panel. Instead, you must edit Joomla&#8217;s primary environment file manually using an FTP client or your host control panel&#8217;s file explorer.<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Establish a remote connection to your web space using an FTP client (such as FileZilla).<\/li>\n\n\n\n<li>Navigate to the root folder where your Joomla directory files are stored (typically inside <code>public_html<\/code>).<\/li>\n\n\n\n<li>Locate the central configuration file named <strong><code>configuration.php<\/code><\/strong>.<\/li>\n\n\n\n<li>Download a local backup copy of this file to your computer before making any adjustments to preserve your original working states.<\/li>\n\n\n\n<li>Open the server-side file inside a text editor and locate the following operational variables:<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>public $debug = '0';\npublic $error_reporting = 'default';\n<\/code><\/pre>\n\n\n\n<ol start=\"6\" class=\"wp-block-list\">\n<li>Modify the parameters to activate maximum diagnostic rendering blocks across your framework layout templates:<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>public $debug = '1';\npublic $error_reporting = 'development';\n<\/code><\/pre>\n\n\n\n<ol start=\"7\" class=\"wp-block-list\">\n<li>Save your edits and re-upload the modified file to your server, overwriting the previous iteration.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Interpreting_the_Debug_Output_Matrix\"><\/span>Interpreting the Debug Output Matrix<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Once these diagnostic features are activated, a specialized graphical console container labeled <strong>Joomla! Debug Console<\/strong> will appear at the very bottom of your webpage layouts. This console compiles essential infrastructure performance data:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Session Parameters:<\/strong> Displays active login details, access tokens, and permission rankings associated with the viewing browser session.<\/li>\n\n\n\n<li><strong>Database Query Logs:<\/strong> Lists every single SQL query executed during the active layout compilation loop. It highlights duplicate calls and identifies unoptimized table lookups that could cause execution drops.<\/li>\n\n\n\n<li><strong>Memory Allocation Pools:<\/strong> Tracks the exact volume of server RAM consumed by the active page request, helping you spot memory leaks in third-party plugins.<\/li>\n\n\n\n<li><strong>Full Error Stack Traces:<\/strong> Instead of displaying an empty screen, Joomla will print out the specific file path, failing function name, and exact code line number responsible for a site crash.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[58],"manual_kb_tag":[7235,7236,7237,7238,543,3034,4213,4258,5116,7234],"class_list":["post-8539","manual_kb","type-manual_kb","status-publish","format-standard","hentry","manualknowledgebasecat-web-applications-cms","manual_kb_tag-joomla-administrator-panel","manual_kb_tag-debug-console","manual_kb_tag-database-query-logs","manual_kb_tag-memory-leaks","manual_kb_tag-white-screen-of-death","manual_kb_tag-global-configuration","manual_kb_tag-error-reporting","manual_kb_tag-enable-debug-mode","manual_kb_tag-configuration-php-file","manual_kb_tag-joomla-debug-mode"],"_links":{"self":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/8539","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":4,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/8539\/revisions"}],"predecessor-version":[{"id":8540,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/8539\/revisions\/8540"}],"wp:attachment":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/media?parent=8539"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manualknowledgebasecat?post=8539"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb_tag?post=8539"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}