Update Joomla and Fix Update Errors

Updating Joomla to the latest version means applying the official update package through System → Update → Joomla (older sites: Components → Joomla Update). A Joomla update error is almost always one of four failures: the update server cannot be reached, PHP runs out of memory or time while downloading the ZIP, files cannot be extracted because of permissions, or the database schema is left behind after files change. Major jumps (3 to 4, 4 to 5, 5 to 6) are upgrades, not one-click patches, and need a staging plan.

This is the Infyways runbook for Joomla 4, 5, and 6. It covers the clean update path, every common error, the manual Upload & Update fallback, and when to stop and hire a migration instead of forcing Live Update.

What you will learn

How to update Joomla to the latest version inside the same major (5.4.x to 5.4.y, or 6.1.x to 6.1.y)
Why a next major does not appear until you switch the update channel
How to read administrator/logs/joomla_update.php so you stop guessing
Fixes for download failures, out of memory, timeouts, extract errors, and database schema lag
The Upload & Update method when the host blocks outbound HTTPS

Update vs upgrade: do not mix them

A Joomla update stays inside one major version. Example: 5.4.2 to 5.4.3, or 6.1.1 to 6.1.2. The built-in updater is the right tool.

A Joomla upgrade changes the major number: 3 to 4, 4 to 5, or 5 to 6. Extensions, PHP, and templates can break. Do that on a staging copy with a tested backup. Our Joomla upgrade service is for that job. This article is for the updater itself and the errors it throws.

Goal	Update channel	Where
Latest patch of your current major	Default	System → Update → Joomla
Next major (for example 5.4 to 6)	Joomla Next	Same screen, Options, then Pre-Update Check
Updater cannot download the ZIP	Either	Download the official update package and use Upload & Update
Joomla 3 or heavily customized site	Do not force one click	Staged migration. See Joomla 3 to 6 path

Official references: Updating from an existing version and Joomla Update problems.

Step 1: Confirm the installed version and the target

Log into the administrator.
Open System → Update → Joomla. If that menu is missing, see the FAQ below (rebuild menus, or look under Components on very old builds).
Note the installed version and the version Joomla offers.
Open System → System Information and record PHP version, database type, and memory limit.

If the offered version is only a patch and Pre-Update Check is green, continue. If you expected Joomla 6 and only see 5.4.x, you are still on the Default channel. That is not a bug.

Step 2: Back up files and the database

Do not click Start Update on a production site without a restorable backup. Use Akeeba or a host snapshot, then keep one copy off the server. Full method: How to backup a Joomla website.

If the update dies halfway, restore first. Debugging a half-written core is slower than a clean restore.

Step 3: Check the server before the download

PHP memory: sites have failed updates at 96 MB and succeeded at 192 MB. Set memory_limit to at least 256M before a core update.
Time: raise max_execution_time (120 seconds or more). Shared hosts also kill long PHP-FPM requests.
Upload limits (needed for the manual ZIP path): upload_max_filesize and post_max_size above the package size (often 20 to 40 MB, sometimes larger).
Writable paths: tmp/, administrator/logs/, and the site root must be writable by PHP.
Outbound HTTPS: the server must reach https://update.joomla.org (and historically GitHub CDNs used by the update infrastructure). Firewalls that block outbound HTTPS cause “failed to download” with a healthy admin.
Disk space: leave room for the ZIP plus extracted files. A full disk looks like a random extract error.

Step 4: Set the update channel

On the Joomla Update screen, open Options.
For a normal latest-version update, keep Update Channel on Default.
Only switch to Joomla Next when you intentionally want the next major, and only after staging, PHP, and extension checks.
Save & Close, then reload the update screen.

Joomla 6 will not appear from Joomla 5.4 until the channel is Joomla Next and the server meets Joomla 6 requirements (current PHP 8.3-class, supported MySQL/MariaDB or PostgreSQL). The Behaviour – Backward Compatibility plugin rules also block that hop if they are wrong. Read Behaviour – Backward Compatibility before a 5.4 to 6 upgrade.

Step 5: Run Pre-Update Check, then start the update

Read Required settings, Recommended settings, and Extensions.
Update or disable extensions that the check flags as incompatible. The check is metadata, not a full runtime test, so still keep the backup.
Confirm you have a backup.
Click Start Update (wording varies slightly by version) and leave the tab open until it finishes.
After success, open System → Maintenance → Database, select Joomla CMS, and click Update Structure / Fix if any tables are listed.
Clear Joomla cache and your host cache. Test the homepage, login, and one form.

Error map: match the symptom to the fix

What you see	Usual cause	Fix
No update offered, or only an old patch	Wrong channel, or update server unreachable	Options → Default or Joomla Next. Then check outbound HTTPS
Failed to download update package / could not connect	Firewall, DNS, TLS, or update.joomla.org blocked	Read the log. Ask the host to allow outbound HTTPS. Use Upload & Update
Out of memory, or download dies with no clear reason	`memory_limit` too low (96 MB is a known failure point)	Raise to 256M and retry. Confirm in System Information
Progress bar stalls, then a timeout or blank page	PHP or proxy timeout during a large ZIP	Raise execution time, retry off-peak, or upload the package manually
Extract failed / could not create file	Permissions, open_basedir, or full disk	Fix ownership on `tmp` and core folders. Free disk. Retry
Files updated, admin shows database errors	SQL schema step did not finish	System → Maintenance → Database → Fix
White screen or 500 right after update	PHP version, incompatible extension, or `.htaccess`	Error log first. See mod_rewrite 500 and extension disable via database if locked out
Class JRequest not found after a major hop	Legacy extension code	Replace JRequest with getInput()
Joomla 6 button missing on 5.4	Channel still Default, or PHP too old, or compat plugin mis-set	Joomla Next + PHP check + compat plugin guide

Step 6: Read the update log before you change ten settings

Open administrator/logs/joomla_update.php (or download it from the host file manager). Look at the last lines around the failure time.

Attempting to download then nothing: connectivity, timeout, or memory during download.
Download failed with a URL on update.joomla.org: outbound HTTPS or TLS.
Error extracting: permissions or disk.
Finalizing / cleanup then a PHP fatal on the next page: the core files may already be new. Fix the extension or PHP error. Do not start a second update on top.

Step 7: Upload & Update when download keeps failing

On a computer that can reach the internet, download the Update Package ZIP for your exact target from the official Joomla downloads (not a random mirror). Use the update package, not the full install package with an installation/ folder, unless you are doing a manual file replace and know the extra steps.
In the administrator open Joomla Update and choose Upload & Update (or the package upload tab).
Upload the ZIP and run the installer.
If upload fails immediately, raise upload_max_filesize and post_max_size, then retry.
Finish with Database Fix and a cache clear.

This bypasses the server’s outbound download. It does not bypass PHP memory during extract, so still raise memory_limit.

Step 8: If the administrator will not load after the update

Read the PHP / host error log. The class or file named there is the clue.
If it is a third-party extension, rename that extension’s folder via FTP (or set enabled = 0 in #__extensions) so Joomla can boot.
If it is .htaccess / mod_rewrite, rename .htaccess temporarily and follow the 500 on mod_rewrite guide.
If the database is mid-schema, restore the backup rather than clicking update again.

Step 9: After a successful update

Confirm the version in System Information matches the package you intended.
Update extensions from System → Update → Extensions.
Re-enable anything you disabled for the check.
Submit the sitemap if URLs changed (they should not on a patch update).
Watch the site for a day. Keep the pre-update backup until you are sure.

When one-click update is the wrong tool

Stop and plan a migration if any of these are true:

You are on Joomla 3 (or older) and want Joomla 5 or 6
Pre-Update Check lists many incompatible extensions you cannot replace yourself
The template is a heavily overridden club template with no vendor update
VirtueMart, K2, or custom components are business-critical
Two update attempts already failed and the log is unclear

Infyways runs those as staged upgrades from $149, with a free compatibility audit. Start at Joomla Upgrade Services or contact us.

Key takeaways

Same-major updates belong in System → Update → Joomla on the Default channel.
Next majors need the Joomla Next channel, current PHP, and a staging backup.
Read joomla_update.php before changing random PHP settings.
Raise memory to at least 256M. 96 MB is a known way to fail the download.
If outbound HTTPS is blocked, Upload & Update with the official update ZIP.
Always run Database Fix after the files change.

Frequently asked questions

How do I update Joomla to the latest version?

Back up the site, open System → Update → Joomla, keep the Default channel for a patch, pass Pre-Update Check, then Start Update. Finish with System → Maintenance → Database if needed.

Why is the Joomla Update menu missing?

On current Joomla it lives under System → Update → Joomla, not always under Components. If the whole administrator menu is broken, rebuild menus from a working backup or ask your host to confirm the admin template is intact.

Why does Joomla say there is no update when I know a new version exists?

You may be on the wrong channel, or the server cannot reach update.joomla.org. Check Options, then the update log.

How do I fix “failed to download the update package”?

Allow outbound HTTPS to update.joomla.org, raise PHP memory and execution time, then retry. If the host still blocks downloads, use Upload & Update with the official ZIP.

The update finished but the site shows database errors. What now?

Go to System → Maintenance → Database, select the Joomla CMS item, and run the structure fix. Do not restore unless that fix fails.

Can I update Joomla 3 to Joomla 6 from this screen?

No. That is a multi-hop upgrade (3.10 to 4.4 to 5.4 to 6), not a single updater click. Use a staged plan.

Is it safe to update on the live site?

Patch updates are usually safe after a backup. Major upgrades should be proven on staging first.

Who can fix a stuck Joomla update for me?

Infyways handles failed updates and full version migrations. Request a Joomla upgrade audit.

How to Update Joomla and Fix Update Errors