Joomla 5 gets more 500 errors than the Joomla 3 version. I am getting used to seeing:

Sorry, there was a problem we could not recover from.

The server returned a "500 - Whoops, looks like something went wrong."

But error 500 doesn't give you many clues as to why there is an error or how to troubleshoot it.

I created this video walk through to help people with this issue.


Or if you prefer reading here are the steps

I want to create a comprehensive set of steps that I can use to try and understand the issue when troubleshooting an error 500.

Here are the things I usually try to check first: ALWAYS START BY TURNING ON JOOMLA DEBUG. It gives you the best clue.

  1. PHP Version. Is it the same as your live site if working on a dev. Is it at least PHP7 if working with Joomla 5?
  2. PHP Settings - although I usually don't find them to be the issue. It's worth checking them too.
  3. Cache type? I usually check configuration.php to see if the cache type is "file" if it is something like Redis you could change it to file to check if Redis is the issue.

public $cache_handler = 'file';

  1. Database Username/password etc. This can cause an error 500, check these settings are correct.

  2. Rename .htaccess and use the default Joomla .htaccess to see if that solves the problem.

  3. Edit your global configuration so that you turn on error reporting to maximum. If you can't do this via the back end, use FTP or a file manager to access configuration.php and edit this line

    public $error_reporting = 'maximum';

  4. Edit your global configuration to set "system debug" to on. If you can't do this via the back end, use FTP or a file manager to access configuration.php and edit this line:

    public $debug = true;

  5. Rename your templates error.php file so the default Joomla one is used in case they are not giving you enough information.

  6. Check the server log files. See if you can spot a plugin or something that is interfering. Then rename that folder to check if that solves it.

  7. Missing PHP module (such as mysql or mbstring). You can find them all here: https://docs.joomla.org/J4.x:Optional_Technical_Requirements. If you can't edit these in your cPanel or hosting options, you might need to use php.ini. Speak to your host to find the right method.

  8. Ask your host.

  9. What changed? What were you just working on? Can you change it back?

  10. Turn off Gzip. Sometimes this makes things funky if error reporting is set to max on some servers.

  • 1
    I would also have a step early on that asks 'What Changed?'. I would also add turn GZIP off as on some of my hosted accounts switching error_reporting to maximum breaks if GZIP is left on. And I would also consider breaking it into sections, 'What to and how to Check', 'Changes you can make to get more diagnostics' & 'Things to do to isolate the issue'. Depends on the audience and whether you are looking for a step by step or flowchart or just a primer for a manual/documentation to point people in the right direction.
    – Irata
    Commented Jun 25 at 3:04
  • 1
    Thank you. I want to create a Joomla Magazine article.
    – Eoin
    Commented Jul 2 at 17:05


Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Browse other questions tagged or ask your own question.