CINXE.COM

<!DOCTYPE html> <html class="client-nojs" lang="en" dir="ltr"> <head> <meta charset="UTF-8"/> <title>J4.x:Updating from an existing version - Joomla! Documentation</title> <script>document.documentElement.className="client-js";RLCONF={"wgBreakFrames":!1,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"df7b00b5161e835654538a12","wgCSPNonce":!1,"wgCanonicalNamespace":"J4.x","wgCanonicalSpecialPageName":!1,"wgNamespaceNumber":148,"wgPageName":"J4.x:Updating_from_an_existing_version","wgTitle":"Updating from an existing version","wgCurRevisionId":1010748,"wgRevisionId":1010748,"wgArticleId":340331,"wgIsArticle":!0,"wgIsRedirect":!1,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Upgrading","Joomla! 4.x","Update Working Group"],"wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"J4.x:Updating_from_an_existing_version","wgRelevantArticleId":340331,"wgIsProbablyEditable":!1,"wgRelevantPageIsProbablyEditable" :!1,"wgRestrictionEdit":[],"wgRestrictionMove":[],"wgMediaViewerOnClick":!0,"wgMediaViewerEnabledByDefault":!0,"wgULSAcceptLanguageList":[],"wgULSCurrentAutonym":"English","wgInternalRedirectTargetUrl":"/J4.x:Updating_from_an_existing_version","wgULSPosition":"personal","wgULSisCompactLinksEnabled":!0,"wgTranslatePageTranslation":"source"};RLSTATE={"site.styles":"ready","noscript":"ready","user.styles":"ready","user":"ready","user.options":"loading","ext.translate":"ready","ext.translate.tag.languages":"ready","skins.jforeground.styles":"ready","mediawiki.toc.styles":"ready","ext.uls.pt":"ready"};RLPAGEMODULES=["mediawiki.action.view.redirect","site","mediawiki.page.startup","mediawiki.page.ready","mediawiki.toc","skins.jforeground.js","mmv.head","mmv.bootstrap.autostart","ext.uls.compactlinks","ext.uls.interface","ext.translate.pagetranslation.uls"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.implement("user.options@1hzgi",function($,jQuery,require,module){/*@nomin*/mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"}); });});</script> <link rel="stylesheet" href="/load.php?lang=en&modules=ext.translate%7Cext.translate.tag.languages%7Cext.uls.pt%7Cmediawiki.toc.styles%7Cskins.jforeground.styles&only=styles&skin=jforeground"/> <script async="" src="/load.php?lang=en&modules=startup&only=scripts&raw=1&skin=jforeground"></script> <meta name="ResourceLoaderDynamicStyles" content=""/> <link rel="stylesheet" href="/load.php?lang=en&modules=site.styles&only=styles&skin=jforeground"/> <meta name="generator" content="MediaWiki 1.35.10"/> <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes, minimum-scale=0.25, maximum-scale=5.0"/> <link rel="apple-touch-icon" href="/apple-touch-icon-precomposed.png"/> <link rel="shortcut icon" href="/favicon.ico"/> <link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="Joomla! Documentation (en)"/> <link rel="EditURI" type="application/rsd+xml" href="//docs.joomla.org/api.php?action=rsd"/> <link rel="license" href="/JEDL"/> <link rel="alternate" type="application/atom+xml" title="Joomla! Documentation Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom"/>  </head> <body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-148 ns-subject page-J4_x_Updating_from_an_existing_version rootpage-J4_x_Updating_from_an_existing_version skin-jforeground action-view"><div id='navwrapper'>  <div id="top-nav" class="fixed"> <nav id="topnav" class="top-bar top row"> <ul class="title-area"> <li class="name logo"> <a href="/Main_Page"> <img alt="Joomla! Documentation" src="/skins/jforeground/joomla_logo_small.png" style="max-width: 64px;height:auto; max-height:36px; display: inline-block; vertical-align:middle;"></a> </li> <li class="toggle-topbar menu-icon"> <a href="#"><span> </span></a> </li> </ul> <section class="top-bar-section"> <ul id="top-bar-left" class="left"> <li class="has-dropdown active" id="p-sidebar-Joomla"> <a href="#">Joomla!</a> <ul class="dropdown"> <li id="n-sidebar-Main"><a href="https://www.joomla.org"><i class="fa fa-joomla 2x-fa icon"></i>Joomla! Home</a></li> <li id="n-sidebar-What"><a href="https://www.joomla.org/about-joomla.html">What is Joomla?</a></li> <li id="n-sidebar-Benefits"><a href="https://www.joomla.org/core-features.html">Benefits & Features</a></li> <li id="n-sidebar-Leadership"><a href="https://www.joomla.org/about-joomla/the-project.html">Project & Leadership</a></li> <li id="n-sidebar-Trademark"><a href="https://tm.joomla.org">Trademark & Licensing</a></li> <li class="divider"></li> <li id="label"><label>Support Joomla!</label></li> <li id="n-sidebar-Contribute"><a href="https://www.joomla.org/contribute-to-joomla.html">Contribute</a></li> <li id="n-sidebar-Sponsorship"><a href="https://www.joomla.org/sponsor.html">Sponsor</a></li> <li id="n-sidebar-Partner"><a href="https://www.joomla.org/about-joomla/partners.html">Partner</a></li> <li id="n-sidebar-Shop"><a href="https://shop.joomla.org/">Shop</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-Extend"> <a href="#">Download & Extend</a> <ul class="dropdown"> <li id="n-sidebar-JoomlaCode"><a href="https://downloads.joomla.org/">Downloads</a></li> <li id="n-sidebar-Extensions"><a href="https://extensions.joomla.org/">Extensions</a></li> <li id="n-sidebar-Translations"><a href="https://community.joomla.org/translations.html">Languages</a></li> <li id="n-sidebar-Free-Hosted"><a href="https://launch.joomla.org">Get a free site</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-About"> <a href="#">Discover & Learn</a> <ul class="dropdown"> <li id="n-sidebar-Docs"><a href="https://docs.joomla.org">Documentation</a></li> <li id="n-sidebar-Training"><a href="https://training.joomla.org">Training</a></li> <li id="n-sidebar-Certification"><a href="https://certification.joomla.org/">Certification</a></li> <li id="n-sidebar-Showcase"><a href="https://showcase.joomla.org/">Site Showcase</a></li> <li id="n-sidebar-Announcements"><a href="https://www.joomla.org/announcements.html">Announcements</a></li> <li id="n-sidebar-Blogs"><a href="https://community.joomla.org/blogs.html">Blogs</a></li> <li id="n-sidebar-Magazine"><a href="https://magazine.joomla.org/">Magazine</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-News"> <a href="#">Community & Support</a> <ul class="dropdown"> <li id="n-sidebar-Community"><a href="https://community.joomla.org/">Community Portal</a></li> <li id="n-sidebar-Events"><a href="https://events.joomla.org/">Events</a></li> <li id="n-sidebar-JUGs"><a href="https://community.joomla.org/user-groups.html">User Groups</a></li> <li id="n-sidebar-Forum"><a href="https://forum.joomla.org/">Forum</a></li> <li id="n-sidebar-Resources"><a href="https://resources.joomla.org/">Resources Directory</a></li> <li id="n-sidebar-Volunteers"><a href="https://volunteers.joomla.org/">Volunteers Portal</a></li> <li id="n-sidebar-Vel"><a href="https://vel.joomla.org">Vulnerable Extensions List</a></li> </ul> </li> <li class="has-dropdown active" id="p-sidebar-Developers"> <a href="#">Developer Resources</a> <ul class="dropdown"> <li id="n-sidebar-Developers"><a href="https://developer.joomla.org/">Developer Network</a></li> <li id="n-sidebar-Security"><a href="https://developer.joomla.org/security-centre.html">Security Centre</a></li> <li id="n-sidebar-Issues"><a href="https://issues.joomla.org/">Issue Tracker</a></li> <li id="n-sidebar-Github"><a href="https://github.com/joomla">GitHub</a></li> <li id="n-sidebar-API"><a href="https://api.joomla.org/">API Documentation</a></li> <li id="n-sidebar-Framework"><a href="https://framework.joomla.org/">Joomla! Framework</a></li> <li id="n-sidebar-JoomlaCode"><a href="http://joomlacode.org/">JoomlaCode</a></li> </ul> </li> </ul> <ul id="top-bar-right" class="right"> <li class="has-dropdown active"><a href="#"><i class="fa fa-cogs"></i></a> <ul id="toolbox-dropdown" class="dropdown"> <li id="t-whatlinkshere"><a href="/Special:WhatLinksHere/J4.x:Updating_from_an_existing_version" title="A list of all wiki pages that link here [j]" accesskey="j">What links here</a></li><li id="t-recentchangeslinked"><a href="/Special:RecentChangesLinked/J4.x:Updating_from_an_existing_version" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k">Related changes</a></li><li id="t-specialpages"><a href="/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q">Special pages</a></li><li id="t-print"><a href="javascript:print();" rel="alternate" title="Printable version of this page [p]" accesskey="p">Printable version</a></li><li id="t-permalink"><a href="/index.php?title=J4.x:Updating_from_an_existing_version&oldid=1010748" title="Permanent link to this revision of the page">Permanent link</a></li><li id="t-info"><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=info" title="More information about this page">Page information</a></li> <li id="n-recentchanges"><a href="/Special:RecentChanges" title="Special:RecentChanges">Recent changes</a></li> <li id="n-help" ><a href="/S:MyLanguage/Help:Contents">Help</a></li> </ul> </li> <li> <a href="/index.php?title=Special:UserLogin&returnto=J4.x%3AUpdating+from+an+existing+version">Log in</a> </li> </ul> </section> </nav> </div> <div id="global-header"> <nav class="global-header"> <div class="row"> <div class="large-6 column"> <h1 class="page-title"> <a href="/Main_Page"> <div class="title-name" style="display: inline-block;">Joomla! Documentation<sup>™</sup></div> </a> </h1> </div> <div class="large-6 column hide-for-small"> <ul class="button-group pull-right"> <li><a href="https://downloads.joomla.org/" class="button success radius" target="_blank">Download</a></li> <li><a href="https://launch.joomla.org/" class="button top radius" target="_blank">Launch</a></li> </ul> </div> </div> </nav> </div> <div id="bottom-nav"> <nav id="bottomnav" class="top-bar bottom row"> <ul class="title-area"> <li class="name"> <h1 class="title-name-small"> <a href="/Main_Page"> <div class="title-name" style="display:none;">Joomla! Documentation<sup>™</sup></div> </a> </h1> </li> <li class="toggle-topbar menu-icon"> <a href="#"><span></span></a> </li> </ul> <section class="top-bar-section"> <ul id="top-bar-left" class="left"> <li class="has-dropdown active" id='p-Learn'> <a href="#">Learn</a> <ul class="dropdown"> <li id="n-More-About-Joomla.21"><a href="/Special:MyLanguage/Portal:Learn_More">More About Joomla!</a></li><li id="n-Beginners"><a href="/Portal:Beginners">Beginners</a></li><li id="n-Administrators"><a href="/Portal:Administrators">Administrators</a></li><li id="n-Developers"><a href="/Portal:Developers">Developers</a></li><li id="n-Joomla.21-Get-Involved"><a href="/Portal:Participating_in_the_Community">Joomla! Get Involved</a></li><li id="n-Joomla.21-Code-Contributors"><a href="/Portal:Joomla!_Code_Contributors">Joomla! Code Contributors</a></li><li id="n-Joomla-User-Groups"><a href="/Special:MyLanguage/Portal:Joomla_User_Groups">Joomla User Groups</a></li> </ul> <li class="has-dropdown active" id='p-Browse'> <a href="#">Browse</a> <ul class="dropdown"> <li id="n-CMS-Help-Screens"><a href="/Help_screens">CMS Help Screens</a></li><li id="n-Our-Docs"><a href="/Category:Top_Level">Our Docs</a></li><li id="n-Our-Glossary"><a href="/Glossary">Our Glossary</a></li><li id="n-The-Joomla.21-FAQs"><a href="/Category:FAQ">The Joomla! FAQs</a></li><li id="n-Tips-and-tricks"><a href="/Category:Tips_and_tricks">Tips and tricks</a></li><li id="n-Recent-Changes"><a href="/Special:RecentChanges">Recent Changes</a></li> </ul> <li class="has-dropdown active" id='p-Help'> <a href="#">Help</a> <ul class="dropdown"> <li id="n-Contribute-to-Joomla.21-Docs"><a href="/JDOC:How_to_Contribute_to_Joomla!_Documentation">Contribute to Joomla! Docs</a></li><li id="n-Translate-Joomla.21-Docs"><a href="/JDOC:Documentation_Translators">Translate Joomla! Docs</a></li><li id="n-Editing-Help"><a href="/JHelp:Cheatsheet">Editing Help</a></li><li id="n-Play-in-the-Sandbox"><a href="/Sandbox">Play in the Sandbox</a></li><li id="n-JDOC.27s-Policies"><a href="/JDOC:Wiki_policy">JDOC's Policies</a></li><li id="n-Documentation-License"><a href="/JEDL">Documentation License</a></li><li id="n-More-Help"><a href="https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents" rel="nofollow" target="_blank">More Help</a></li> </ul> </ul> <ul id="top-bar-right" class="right"> <li class="has-form"> <form action="/index.php" id="searchform" class="mw-search"> <div class="row"> <div class="small-12 columns"> <input type="search" name="search" placeholder="Search Joomla! Documentation" title="Search Joomla! Documentation [f]" accesskey="f" id="searchInput"/> <button type="submit" class="button search main">Search</button> </div> </div> </form> </li> </ul> </section> </nav> </div> </div> <div id="page-content"> <div class="row"> <div class="large-12 columns">   <div class="mw-indicators mw-body-content"> </div>  </div> </div> <div id="mw-js-message" style="display:none;"></div> <div class="row"> <div id="p-cactions" class="large-12 columns"> <h4 class="namespace label">J4.x</h4> <article id="content"> <h1 class="title">Updating from an existing version</h1> <h3 id="tagline">From Joomla! Documentation</h3> <h5 class="subtitle"></h5> <div id="ad"> <script async="" type="text/javascript" src="//cdn.carbonads.com/carbon.js?zoneid=1673&serve=C6AILKT&placement=joomlaorg" id="_carbonads_js"></script> </div> <div class="clear_both"></div> <div class="mw-bodytext"> <div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-pt-languages noprint" lang="en" dir="ltr"><div class="mw-pt-languages-label">Other languages:</div><div class="mw-pt-languages-list"><a href="/J4.x:Updating_from_an_existing_version/de" class="mw-pt-progress mw-pt-progress--med" title="Aktualisierung einer bestehenden Version (57% translated)" lang="de">Deutsch</a> • ‎<span class="mw-pt-languages-ui mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete" lang="en">English</span></div></div><p><br /> </p><div data-alert="" class="alert-box alert"><center><big><b>Always back up your site before updating.</b></big></center></div> <div id="toc" class="toc" role="navigation" aria-labelledby="mw-toc-heading"><input type="checkbox" role="button" id="toctogglecheckbox" class="toctogglecheckbox" style="display:none" /><div class="toctitle" lang="en" dir="ltr"><h2 id="mw-toc-heading">Contents</h2><span class="toctogglespan"><label class="toctogglelabel" for="toctogglecheckbox"></label></span></div> <ul> <li class="toclevel-1 tocsection-1"><a href="#Introduction"><span class="tocnumber">1</span> <span class="toctext">Introduction</span></a></li> <li class="toclevel-1 tocsection-2"><a href="#Accessing_the_Update_Component"><span class="tocnumber">2</span> <span class="toctext">Accessing the Update Component</span></a></li> <li class="toclevel-1 tocsection-3"><a href="#Carrying_Out_the_Update"><span class="tocnumber">3</span> <span class="toctext">Carrying Out the Update</span></a> <ul> <li class="toclevel-2 tocsection-4"><a href="#Confirming_the_Update"><span class="tocnumber">3.1</span> <span class="toctext">Confirming the Update</span></a></li> <li class="toclevel-2 tocsection-5"><a href="#Update_Progress"><span class="tocnumber">3.2</span> <span class="toctext">Update Progress</span></a></li> <li class="toclevel-2 tocsection-6"><a href="#Completion"><span class="tocnumber">3.3</span> <span class="toctext">Completion</span></a></li> </ul> </li> <li class="toclevel-1 tocsection-7"><a href="#Post_Update_Checks"><span class="tocnumber">4</span> <span class="toctext">Post Update Checks</span></a> <ul> <li class="toclevel-2 tocsection-8"><a href="#Frontend_Check"><span class="tocnumber">4.1</span> <span class="toctext">Frontend Check</span></a></li> <li class="toclevel-2 tocsection-9"><a href="#System_Checks"><span class="tocnumber">4.2</span> <span class="toctext">System Checks</span></a> <ul> <li class="toclevel-3 tocsection-10"><a href="#Recommended_Steps_and_Actions"><span class="tocnumber">4.2.1</span> <span class="toctext">Recommended Steps and Actions</span></a></li> </ul> </li> </ul> </li> <li class="toclevel-1 tocsection-11"><a href="#Checking_Your_Site"><span class="tocnumber">5</span> <span class="toctext">Checking Your Site</span></a></li> <li class="toclevel-1 tocsection-12"><a href="#Extension_Manager:_Discover"><span class="tocnumber">6</span> <span class="toctext">Extension Manager: Discover</span></a></li> <li class="toclevel-1 tocsection-13"><a href="#Troubleshooting"><span class="tocnumber">7</span> <span class="toctext">Troubleshooting</span></a></li> <li class="toclevel-1 tocsection-14"><a href="#Troubleshooting_Joomla_Update"><span class="tocnumber">8</span> <span class="toctext">Troubleshooting Joomla Update</span></a> <ul> <li class="toclevel-2 tocsection-15"><a href="#Determining_If_Updates_Exist"><span class="tocnumber">8.1</span> <span class="toctext">Determining If Updates Exist</span></a></li> <li class="toclevel-2 tocsection-16"><a href="#Determining_If_Third_Party_Software_is_Compatible_With_the_New_Version_You_are_About_to_Install"><span class="tocnumber">8.2</span> <span class="toctext">Determining If Third Party Software is Compatible With the New Version You are About to Install</span></a></li> <li class="toclevel-2 tocsection-17"><a href="#Downloading_the_Update"><span class="tocnumber">8.3</span> <span class="toctext">Downloading the Update</span></a></li> <li class="toclevel-2 tocsection-18"><a href="#Extracting_the_Update"><span class="tocnumber">8.4</span> <span class="toctext">Extracting the Update</span></a></li> <li class="toclevel-2 tocsection-19"><a href="#Finalising_the_Update"><span class="tocnumber">8.5</span> <span class="toctext">Finalising the Update</span></a></li> </ul> </li> </ul> </div> <h2><span class="mw-headline" id="Introduction">Introduction</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=1" title="Edit section: Introduction">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>The recommended way to update installations of Joomla! is to use the Joomla Update Component. </p><p>A standard installation of Joomla 4 includes a helpful notifications panel on the Home Dashboard after logging into the Administrator. You can see at a glance if an update is available and the version number. </p><p>Although Joomla will notify you when an update is available, it requires you to carry out the update. It is a straight forward process and should be carried out at the earliest opportunity to keep the site up to date. </p><p>If you are updating from a Joomla version prior to 4.x, see one or more of the following: </p> <ul><li><a href="/Special:MyLanguage/Potential_backward_compatibility_issues_in_Joomla_4" title="Special:MyLanguage/Potential backward compatibility issues in Joomla 4">Potential backward compatibility issues in Joomla 4</a></li> <li><a href="/Special:MyLanguage/Joomla_3.x_to_4.x_Step_by_Step_Migration" title="Special:MyLanguage/Joomla 3.x to 4.x Step by Step Migration">Joomla 3.x to 4.x Step by Step Migration</a></li> <li>Updating 1.x or 2.x to 3.x: use <a href="/Special:MyLanguage/J3.x:Updating_Joomla_(Install_Method)" title="Special:MyLanguage/J3.x:Updating Joomla (Install Method)">Updating Joomla (Install Method)</a>.</li></ul> <h2><span class="mw-headline" id="Accessing_the_Update_Component">Accessing the Update Component</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=2" title="Edit section: Accessing the Update Component">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>If the notifications panel is displayed in the Home Dashboard, clicking the notification takes you straight to the Update Component. </p><p><a href="/File:J4x_joomla_update_notification-en.png" class="image"><img alt="J4x joomla update notification-en.png" src="/images/thumb/f/f5/J4x_joomla_update_notification-en.png/800px-J4x_joomla_update_notification-en.png" decoding="async" width="800" height="355" class="thumbborder" srcset="/images/f/f5/J4x_joomla_update_notification-en.png 1.5x" data-file-width="1000" data-file-height="444" /></a> </p> <div style="clear:both;"></div> <p>Alternatively, to access the Update Component from the Administrator sidebar menu, click <i>System</i>. This will take you to the <i>System Dashboard</i>. </p><p><a href="/File:J4x_joomla_system_dashboard_update-en.png" class="image"><img alt="J4x joomla system dashboard update-en.png" src="/images/thumb/1/14/J4x_joomla_system_dashboard_update-en.png/800px-J4x_joomla_system_dashboard_update-en.png" decoding="async" width="800" height="319" class="thumbborder" srcset="/images/1/14/J4x_joomla_system_dashboard_update-en.png 1.5x" data-file-width="1000" data-file-height="399" /></a> </p> <div style="clear:both;"></div> <p>The System Dashboard has an <i>Update Panel</i> that includes a Joomla link that will show the available update version number. Click the <i>Joomla</i> link and you will be taken to the Update Component. </p> <h2><span class="mw-headline" id="Carrying_Out_the_Update">Carrying Out the Update</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=3" title="Edit section: Carrying Out the Update">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p><a href="/File:J4x_joomla_pre_update_check-en.png" class="image"><img alt="J4x joomla pre update check-en.png" src="/images/thumb/5/5d/J4x_joomla_pre_update_check-en.png/800px-J4x_joomla_pre_update_check-en.png" decoding="async" width="800" height="706" class="thumbborder" srcset="/images/5/5d/J4x_joomla_pre_update_check-en.png 1.5x" data-file-width="1000" data-file-height="882" /></a> </p> <div style="clear:both;"></div> <p>At the Joomla Update Component you will be presented with a Pre-Update Check that provides you with information about the readiness of your server, settings and installed extensions for the update. </p><p>Pay careful attention to these and take action to rectify any issues highlighted before updating. You may need to double check extensions and update them first. </p><p>It is not uncommon to see warnings for <i>Recommended Settings</i> as these are often server specific and hosting related - it is likely they existed when you installed Joomla and most likely won't prevent the update from happening. </p><p><i>Note the reminder that you are strongly advised to take a backup if you haven't already!</i> </p><p>There is a link below the update button. In most cases you can ignore this link. It provides an option to manually upload the update files if your server is behind a firewall or otherwise unable to contact the Joomla update servers. </p><p>When you have reviewed the Pre-Update Check and are happy, select <i>Update</i>. </p> <h3><span class="mw-headline" id="Confirming_the_Update">Confirming the Update</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=4" title="Edit section: Confirming the Update">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p><a href="/File:J4x_joomla_start_update-en.png" class="image"><img alt="J4x joomla start update-en.png" src="/images/thumb/c/c3/J4x_joomla_start_update-en.png/800px-J4x_joomla_start_update-en.png" decoding="async" width="800" height="516" class="thumbborder" srcset="/images/c/c3/J4x_joomla_start_update-en.png 1.5x" data-file-width="1000" data-file-height="645" /></a> </p><p>Click the checkbox to confirm you have made a backup and checked extensions are compatible then select the <i>Start Update</i>. </p> <h3><span class="mw-headline" id="Update_Progress">Update Progress</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=5" title="Edit section: Update Progress">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p><a href="/File:J4x_joomla_update_progress-en.png" class="image"><img alt="J4x joomla update progress-en.png" src="/images/thumb/c/cd/J4x_joomla_update_progress-en.png/800px-J4x_joomla_update_progress-en.png" decoding="async" width="800" height="154" class="thumbborder" srcset="/images/c/cd/J4x_joomla_update_progress-en.png 1.5x" data-file-width="1000" data-file-height="193" /></a> </p><p>Once the update starts a progress bar will appear as Joomla is updated. </p> <h3><span class="mw-headline" id="Completion">Completion</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=6" title="Edit section: Completion">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p><a href="/File:J4x_joomla_updated-en.png" class="image"><img alt="J4x joomla updated-en.png" src="/images/thumb/9/9a/J4x_joomla_updated-en.png/800px-J4x_joomla_updated-en.png" decoding="async" width="800" height="219" class="thumbborder" srcset="/images/9/9a/J4x_joomla_updated-en.png 1.5x" data-file-width="1000" data-file-height="274" /></a> </p><p>When the progress bar reaches 100% a notification will confirm that your site has been updated and the version number. The version number will also update in the top toolbar next to the site name. </p><p>Click the <i>Back</i> button and you will be returned to the Joomla Update Component where it is possible to check for updates again. </p> <h2><span class="mw-headline" id="Post_Update_Checks">Post Update Checks</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=7" title="Edit section: Post Update Checks">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>Once the update is complete you should carry out some checks to make sure everything went as expected, that no errors are present and that there have been no changes that require further action. </p> <h3><span class="mw-headline" id="Frontend_Check">Frontend Check</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=8" title="Edit section: Frontend Check">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Go to the front end of the website and check it is working and displaying as it did prior to the update. </p><p>As a matter of course, clear your browser cache as this will load any changes to style sheets and scripts. </p> <h3><span class="mw-headline" id="System_Checks">System Checks</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=9" title="Edit section: System Checks">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Joomla makes it easy to do a "health" check. From the sidebar menu click <i>System</i> to be taken to the System Dashboard. This gives you an overview of the current status of your Joomla site. </p><p><a href="/File:J4x_system_dashboard-en.png" class="image"><img alt="J4x system dashboard-en.png" src="/images/thumb/7/71/J4x_system_dashboard-en.png/800px-J4x_system_dashboard-en.png" decoding="async" width="800" height="572" class="thumbborder" srcset="/images/7/71/J4x_system_dashboard-en.png 1.5x" data-file-width="1000" data-file-height="715" /></a> </p><p>In this example we can see that since the update we have two items that require attention. They are marked with a label that includes a number. The number relates to how many items require attention. Clicking on each one will allow you to fix them. </p><p><b>Note</b> The System Dashboard makes a check each time the page is loaded. Bear in mind that browser caching settings could affect this. It's good practice to clear the browser's cache when checking. </p> <h4><span class="mw-headline" id="Recommended_Steps_and_Actions">Recommended Steps and Actions</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=10" title="Edit section: Recommended Steps and Actions">edit</a><span class="mw-editsection-bracket">]</span></span></h4> <p>It is recommended that you follow these steps when updating a production site: </p> <ol><li>Back up your site before updating to a new version. If something goes wrong during the update process, you can easily restore your site to the earlier version.</li> <li>Review the release notes for the new version to be familiar with what was changed.</li> <li>Update using one of the recommended methods outlined in this document. These methods install the new program files, delete unneeded old program files, and update the database as needed for the new Joomla version.</li> <li>Clear your browser's cache and check that the update was successful, using the steps outlined in the <b>Checking Your Site</b> tab.</li></ol> <h2><span class="mw-headline" id="Checking_Your_Site">Checking Your Site</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=11" title="Edit section: Checking Your Site">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>After an update, it is a good idea to clear your browser cache and check your site to make sure the update was successful. There are two quick checks you can do from the Extension Manager. </p><p>Navigate to <b>Extension Manager<span style="font-size:1.40em;"> </span></b>→<b> Database</b>. If your database is up to date, you should see a screen similar to the one below: </p><p><a href="/File:J4x-update-screenshot-db-ok-en.png" class="image" title="Database Screen With No Problems"><img alt="Database Screen With No Problems" src="/images/thumb/0/08/J4x-update-screenshot-db-ok-en.png/800px-J4x-update-screenshot-db-ok-en.png" decoding="async" width="800" height="347" class="thumbborder" srcset="/images/0/08/J4x-update-screenshot-db-ok-en.png 1.5x" data-file-width="1000" data-file-height="434" /></a> </p><p>If your database is not up to date, you will see a screen listing the problems found, similar to the one below: </p><p><a href="/File:J4x-update-screenshot-db-not-ok-en.png" class="image" title="Database Screen With 3 Database Problems"><img alt="Database Screen With 3 Database Problems" src="/images/thumb/4/42/J4x-update-screenshot-db-not-ok-en.png/800px-J4x-update-screenshot-db-not-ok-en.png" decoding="async" width="800" height="422" class="thumbborder" srcset="/images/4/42/J4x-update-screenshot-db-not-ok-en.png 1.5x" data-file-width="1000" data-file-height="527" /></a> </p><p>In this case, press the Fix button in the upper right corner. Joomla will update your database to correct the issues listed and then it will re-display the screen. If the fix was successful, the display will indicate that the database is up to date. </p><p><b>N.B.</b> If any errors still exist make sure all the database tables are checked in. </p> <h2><span class="mw-headline" id="Extension_Manager:_Discover">Extension Manager: Discover</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=12" title="Edit section: Extension Manager: Discover">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>In some cases, when you update to a new Joomla version, new core extensions are added. If there were problems with the database update, these extensions may not have been correctly installed. To check this, navigate to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Discover</b>. Then click on the Discover icon in the toolbar. The screen should show as follows: </p><p><a href="/File:J4x-update-screenshot-extensions-en.png" class="image" title="Discover Screen With No Extensions To Install"><img alt="Discover Screen With No Extensions To Install" src="/images/thumb/1/12/J4x-update-screenshot-extensions-en.png/800px-J4x-update-screenshot-extensions-en.png" decoding="async" width="800" height="431" class="thumbborder" srcset="/images/1/12/J4x-update-screenshot-extensions-en.png 1.5x" data-file-width="1000" data-file-height="539" /></a> </p><p>If so, you know that any new extensions added during the update were correctly installed in the database. </p><p>If there are uninstalled extensions, they will show similar to the following screen: </p><p><a href="/File:J4x-update-screenshot-uninstalled-ext-en.png" class="image" title="Discover Screen With One Extension To Install"><img alt="Discover Screen With One Extension To Install" src="/images/thumb/1/13/J4x-update-screenshot-uninstalled-ext-en.png/800px-J4x-update-screenshot-uninstalled-ext-en.png" decoding="async" width="800" height="260" class="thumbborder" srcset="/images/1/13/J4x-update-screenshot-uninstalled-ext-en.png 1.5x" data-file-width="1000" data-file-height="325" /></a> </p><p>In this case, check the boxes and click on the Install icon in the toolbar. Joomla will install the extension(s) and then display the screen showing no extensions discovered. At this point, the new extensions have been installed in the database. </p> <h2><span class="mw-headline" id="Troubleshooting">Troubleshooting</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=13" title="Edit section: Troubleshooting">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>If you have any questions, problems or errors before, during or after the update, please ask them on the <i><a href="https://forum.joomla.org/viewforum.php?f=812" class="extiw" title="jforum:812">Migrating and Upgrading to Joomla! 4.x Forum</a></i>. </p><p>If you have problems or errors during the update process, here are some tips. </p> <ul><li>Clearing your browser cache. There may have been changes to the CSS or JavaScript that will need to be reloaded by your Web browser after an update.</li> <li>If any database error messages show after the update, be sure to check the <b>System<span style="font-size:1.40em;"> </span></b>→<b> Maintenance panel<span style="font-size:1.40em;"> </span></b>→<b> Database</b> link. In some cases, if a database error occurs it will prevent all of the database updates from running. In this case, you can run them from the Database link and then use the <b>System<span style="font-size:1.40em;"> </span></b>→<b> Install<span style="font-size:1.40em;"> </span></b>→<b> Discover</b> method to check and install any new extensions.</li></ul> <h2><span class="mw-headline" id="Troubleshooting_Joomla_Update">Troubleshooting Joomla Update</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=14" title="Edit section: Troubleshooting Joomla Update">edit</a><span class="mw-editsection-bracket">]</span></span></h2> <p>Joomla Update is a core component which is responsible for determining if there is a newer version of Joomla available for installation of your site, download it (or let you upload it) and install it. It has been available in Joomla since Joomla 2.5.1 and as a third party extension two years prior to that. You can access it at System, Update, Joomla. </p><p>The update process consists of several different steps. While every care has been taken to make this process as trouble–free as possible there's always a small chance that something may go wrong, typically due to a very restrictive server configuration or network conditions on a very small minority of sites. </p><p>The following troubleshooting instructions are organised by update step to make it easier to find the information you are looking for. Furthermore, it is an exhaustive resource, based on more than a decade of experience troubleshooting all possible (and some borderline impossible) problems with Joomla and extension updates. It lists problems which are extremely unlikely to occur. Don't let its length scare you; you are very unlikely to ever see any of these problems occur. </p> <h3><span class="mw-headline" id="Determining_If_Updates_Exist">Determining If Updates Exist</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=15" title="Edit section: Determining If Updates Exist">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Joomla will make a request to its update server over HTTPS and download an XML file provided by the Joomla project listing the latest available versions. The update server in use can be determined by going to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Joomla<span style="font-size:1.40em;"> </span></b>→<b> Options</b> and examining which update server is in use. You should use the <i>Default</i> update server to receive updates to your current major version of Joomla. Use <i>Joomla Next</i> when you want to upgrade your site to the next major version of Joomla — this is best done on a copy of your site to avoid any nasty surprises; not all third party extensions and templates will be compatible across major Joomla versions. The major version of Joomla is the first digit in the Joomla version, before the first dot. For example, the major version of Joomla 4.0.1 is 4. </p><p>If Joomla cannot determine that an update is available please check the following: </p> <ul><li>The Joomla Update information is out of date in the database. Go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Joomla<span style="font-size:1.40em;"> </span></b>→<b> Check for Updates</b>.</li> <li>The update sites information in Joomla is corrupt. Go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Update Sites<span style="font-size:1.40em;"> </span></b>→<b> Rebuild</b>. Then go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Joomla<span style="font-size:1.40em;"> </span></b>→<b> Options</b>. Select the Testing update channel. Select <i>Save & Close</i>. Click on Options again. Select the <i>Default</i> or <i>Joomla Next</i> update channel — depending on your preference — and click on <i>Save & Close</i>.</li> <li>Your host prevents making outbound HTTPS requests at all or restricts them to predefined allowed IP addresses. Please ask them to allow outbound HTTP requests to <a target="_blank" rel="noreferrer noopener" class="external free" href="https://update.joomla.org">https://update.joomla.org</a>. This is a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.</li> <li>Your host may have an outdated SSL library which does not understand the modern TLS certificates used by the Joomla update CDN. Please ask your host about it.</li></ul> <h3><span class="mw-headline" id="Determining_If_Third_Party_Software_is_Compatible_With_the_New_Version_You_are_About_to_Install">Determining If Third Party Software is Compatible With the New Version You are About to Install</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=16" title="Edit section: Determining If Third Party Software is Compatible With the New Version You are About to Install">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Joomla does not have a magical way of evaluating third party code for compatibility. Its report is based solely on the extension information kept in Joomla's <i>#__extensions</i> table, the update sites provided by the installed extensions and the update information provided by the developers of third party extensions including but not limited to which version of their software is compatible with which version of Joomla. </p><p>If the information displayed is incorrect please check the following: </p> <ul><li>What is the minimum stability for extension updates? Go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Extensions<span style="font-size:1.40em;"> </span></b>→<b> Options</b>. The <i>Minimum Extension Stability</i> determines which is the minimum stability level of a third party software that Joomla will take into account when evaluating compatibility. For example, if this option is set to <i>Stable</i> but only a beta version of a third party extension is compatible with the Joomla version you want to upgrade to Joomla will tell you that there is no compatible version of the third party extension available.</li> <li>The update information may be out of date. Go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Extensions<span style="font-size:1.40em;"> </span></b>→<b> Check For Updates</b>. Then go back to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Joomla</b> and see if the extension now appears as compatible or if you are told than a compatible update is available.</li> <li>The update sites information in Joomla is corrupt. Go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Update Sites<span style="font-size:1.40em;"> </span></b>→<b> Rebuild</b>. Then go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Joomla<span style="font-size:1.40em;"> </span></b>→<b> Options</b>. Select the <i>Testing</i> update channel. Select <i>Save & Close</i>. Click on <i>Options</i> again. Select the <i>Default</i> or <i>Joomla Next</i> update channel — depending on your preference — and click on <i>Save & Close</i>.</li> <li>Your host prevents making outbound HTTP/HTTPS requests at all or restricts them to predefined allowed IP addresses. This will prevent Joomla from retrieving update information from third party update sites. First go to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Update<span style="font-size:1.40em;"> </span></b>→<b> Update Sites</b>. Below each update site you will see its URL. Make a list of those URLs. Then ask your host to allow your site to make requests to these URLs. Please note that some of these URLs may point to a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.</li> <li>Your host may have an outdated SSL library which does not understand the modern TLS certificates used by most third party extension developers' update sites. Please ask your host about it.</li> <li>You may have 'orphaned' extensions. Most modern Joomla extensions are delivered as ‘package’ type extensions which include two or more related extensions. When installing a package extension Joomla records a package extension in its database. It then records the package ID to each of the installed extensions from that package in the database. The update information is provided for the package, not each individual extension. This association may break if you used <i>Discover</i> to install the extensions, extracted the package and installed the separate extensions directly. Joomla failed to record the package ID for each extension when installing the package (most likely because an error occurred) or your site has been upgraded from an old version of Joomla which predates the use of packages in extensions. In this case even updating the extension will <b>not</b> update the package association. There is currently no solution to this except determining manually the compatibility of extensions with each Joomla version.</li> <li>In some cases the number of requests Joomla sends to your server as it determines compatibility for each extension may overwhelm the server and trigger a Denial of Service protection. In this case some or all of the extensions will appear as of indeterminate compatibility status. Unfortunately, you will have to check the compatibility of each extension manually against the information published by extension's developer.</li></ul> <h3><span class="mw-headline" id="Downloading_the_Update">Downloading the Update</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=17" title="Edit section: Downloading the Update">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>Joomla will need to download its update package, a ZIP file which is similar to the Joomla installation ZIP file but without the web installer (the <i>installation</i> directory). This could fail for a few reasons: </p> <ul><li>The ZIP file is rather big. Joomla 4 update packages are around 25 MiB. If your server is slow, overwhelmed or has poor connectivity with GitHub — where Joomla update packages are downloaded — it may take a long time to download the package. If that time is longer than your server's PHP maximum execution time, its maximum CPU usage limit (as determined by ulimit -t in the server command line), the PHP-FPM timeout or the web server's timeout the download will fail and you will see an error page. You will have to ask your host for help with that.</li> <li>You may not have enough free space on your site. You need enough space to store the compressed update ZIP file and its extracted files. As a rule of thumb, you need about 50–60 MiB of free space for Joomla Update to work correctly. Do note that the free space reported by your hosting control panel is not always realtime, i.e. it may 'lag' several minutes or hours behind the actual disk space usage on your site. Moreover, further limits may be imposed by your host. If unsure, please ask your host.</li> <li>Your host prevents making outbound HTTPS requests at all or restricts them to predefined allowed IP addresses. Please ask them to allow outbound HTTP requests to <i><a target="_blank" rel="nofollow noreferrer noopener" class="external free" href="https://github.com">https://github.com</a></i>. This is a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.</li> <li>Your host may have an outdated SSL library which does not understand the modern TLS certificates used by GitHub. Please ask your host about it.</li></ul> <h3><span class="mw-headline" id="Extracting_the_Update">Extracting the Update</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=18" title="Edit section: Extracting the Update">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>After the update ZIP file has downloaded Joomla needs to extract it on your site. Since Joomla is effectively replacing itself and because this process does take some time to complete it cannot happen within Joomla itself. Instead, a separate file (<i>administrator/components/com_joomlaupdate/extract.php</i>) is used to perform the update. This file is inert except when an update is in progress. </p><p>You may get an error during the extraction for one of the following reasons: </p> <ul><li>You cannot access the <i>extract.php</i> file because of a server protection e.g. a customised <i>.htaccess</i> file on Apache and Litespeed servers. Try accessing <i><a target="_blank" rel="nofollow noreferrer noopener" class="external free" href="https://www.example.com/administrator/components/com_joomlaupdate/extract.php">https://www.example.com/administrator/components/com_joomlaupdate/extract.php</a></i> from a web browser, where <i><a target="_blank" rel="nofollow noreferrer noopener" class="external free" href="https://www.example.com/">https://www.example.com/</a></i> is to be replaced with the URL to your site. You should see the message {"status":false,"message":"Invalid login"} If you see anything else you are being forbidden from accessing this file.</li> <li>If you can access the file but extracting the update fails immediately, there is a different server protection on your site which prevents the request to <i>extract.php</i> from being handled by that file. Please contact your host about this.</li> <li>If you are using CloudFlare, go to Rules and create a new Page Rule. Set the <i>If URL Matches</i> to <i>*/administrator/components/com_joomlaupdate/extract.php</i> and Then The Settings Are to “Disable Security” and on a new line ”Cache Level”, ‘Bypass’. Set the Order to <i>First</i>. Click on Save and Deploy. This ensures that CloudFlare will not try to block the update extraction.</li> <li>The update ZIP file is corrupt or truncated. This could happen if downloading the update file failed with an error. Go back and retry. See also the previous section.</li> <li>If you are using upload and update, i.e. you uploaded the update ZIP file yourself, please make sure that you are using only the official Joomla Update ZIP files. The extraction script only supports a subset of the ZIP archive format used by the official update ZIP files.</li> <li>Did you run out of disk space? Please check the section above.</li> <li>Are the ownership and permissions of all files correct? Joomla needs write access to all of its files and folders. If unsure, ask your host. There is no specific set of “good” permissions! The permissions needed depend on the ownership of your files and which system user the web server runs under.</li> <li>Did you lose network connectivity or your network has very high latency? It's possible that the request fails because of that.</li> <li>The extraction takes place by making consecutive requests to the aforementioned <i>extract.php</i> file. Each request is set up to take between 3 and 4 seconds. The process repeats until the entirety of the update file has been extracted. On some servers this cadence of requests to the same file from the same IP address may trigger the server's security. On other servers it may trigger a different server protection, e.g. a maximum PHP time limit, a maximum CPU usage limit or another server timeout. On even fewer servers running on CloudLinux, it could trigger a server memory outage situation if your server was already running low on memory. Contact your server about that; there is nothing you can do yourself to work around these server limitations.</li></ul> <h3><span class="mw-headline" id="Finalising_the_Update">Finalising the Update</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/index.php?title=J4.x:Updating_from_an_existing_version&action=edit&section=19" title="Edit section: Finalising the Update">edit</a><span class="mw-editsection-bracket">]</span></span></h3> <p>This is a two step process. </p><p>Right after the update ZIP file has been extracted, a final step will run which removes old files. When upgrading to a new major version of Joomla the list of files to remove is large and the process may timeout. Moreover, the point made in the previous section about ownership and permissions of files is important here too; Joomla needs write permissions to the old files and folders it has to remove. If this step fails you can resume it from the command line. Go into the <i>cli</i> folder and run <i>php joomla.php update:joomla:remove-old-files</i>. If you cannot do it yourself ask your host to do it for you. You will also need to follow the workaround for the next step. </p><p>Finally, Joomla reloads and you are logged back into the Administrator interface. At this point Joomla updates its database tables and performs any database administration tasks. If this fails you can resume the process by going to <b>System<span style="font-size:1.40em;"> </span></b>→<b> Maintenance<span style="font-size:1.40em;"> </span></b>→<b> Database</b>. Select <i>Joomla CMS</i> from the list and click on <i>Update Structure</i>. </p>    </div></div></div><div class="printfooter"> Retrieved from "<a dir="ltr" href="https://docs.joomla.org/index.php?title=J4.x:Updating_from_an_existing_version&oldid=1010748">https://docs.joomla.org/index.php?title=J4.x:Updating_from_an_existing_version&oldid=1010748</a>"</div> <div class="clear_both"></div> </div> <div class="group"><div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/Special:Categories" title="Special:Categories">Categories</a>: <ul><li><a href="/Category:Upgrading" title="Category:Upgrading">Upgrading</a></li><li><a href="/Category:Joomla!_4.x" title="Category:Joomla! 4.x">Joomla! 4.x</a></li><li><a href="/Category:Update_Working_Group" title="Category:Update Working Group">Update Working Group</a></li></ul></div></div></div> </article> </div> </div> <footer class="row"> <div id="footer"> <div id="footer-left" class="large-8 small-12 columns"> <ul id="footer-left"> <li id="footer-lastmod"> This page was last edited on 18 August 2023, at 07:24.</li> <li id="footer-copyright">Content is available under <a href="/JEDL" title="JEDL">Joomla! EDL</a> unless otherwise noted.<br>Joomla!<sup>®</sup> is a registered trademark of Open Source Matters, Inc.<br>If you are experiencing technical issues with this website, <html><a href="https://github.com/joomla/joomla-websites/issues/new?title=%5Bjdocs%5D%20&body=Please%20describe%20the%20problem%20or%20your%20issue" target="_blank" rel="nofollow">please report it</a> </html>. <br>Notice a content problem? <html><a href="/JDOC:How_to_Contribute_to_Joomla!_Documentation" rel="nofollow">Create an account</a> </html> and fix it.</li> <li id="footer-privacy"><a href="/JDOC:Privacy_policy" title="JDOC:Privacy policy">Privacy policy</a></li> <li id="footer-about"><a href="/JDOC:About" title="JDOC:About">About Joomla! Documentation</a></li> <li id="footer-disclaimer"><a href="/JDOC:General_disclaimer" class="mw-redirect" title="JDOC:General disclaimer">Terms of Service</a></li> </ul> </div> <div id="footer-right-icons" class="large-4 small-12 columns"> <ul id="poweredby"> <li class="copyright"> <a href="https://docs.joomla.org/JEDL" target="_blank"><img src="https://docs.joomla.org/skins/JEDL_icon.png" alt="Joomla! EDL" width="88" height="31" loading="lazy"/></a> </li> <li class="poweredby"> <a href="https://www.mediawiki.org/" target="_blank"><img src="/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31" loading="lazy"/></a> </li> <li class="rochen"> <a href="https://www.rochen.com/joomla-hosting" target="_blank"><img src="//cdn.joomla.org/rochen/rochen_footer_logo_white.png" alt="Joomla! Hosting by Rochen..." width="88" height="31" loading="lazy"/></a> </li> </ul> </div> </div> </footer> </div> <script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgPageParseReport":{"limitreport":{"cputime":"0.148","walltime":"0.165","ppvisitednodes":{"value":586,"limit":1000000},"postexpandincludesize":{"value":8487,"limit":2097152},"templateargumentsize":{"value":952,"limit":2097152},"expansiondepth":{"value":5,"limit":40},"expensivefunctioncount":{"value":0,"limit":100},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":474,"limit":5000000},"timingprofile":["100.00% 12.245 1 -total"," 36.83% 4.509 3 Template:-"," 28.08% 3.438 15 Template:Rarr"," 25.24% 3.091 1 Template:Note"]},"cachereport":{"timestamp":"20241118170839","ttl":86400,"transientcontent":false}}});mw.config.set({"wgBackendResponseTime":447});});</script> </body>  </html>