Start a FREE 7 day trial! Get training videos and books, plus expert support:  

Joomla Tutorials and Blog Posts

How to Upgrade from Joomla 2.5 to Joomla 3

Joomla 3In this tutorial we're going show you how to update from Joomla 2.5 to Joomla 3.

Three things to note before we begin:

  1. Joomla 2.5 is the Long Term Support version and offers a stable platform for most sites.
  2. This update is currently recommended only for relatively simple sites.
  3. A more sophisticated update process is expected to be available for Joomla 3.1 early this year. Look for more details on that later this week.

However, for people who do want to use Joomla 3, the update process from Joomla 2.5 to 3 does work and in this tutorial, we're going to show you how to use it.

1) Create a backup

2) Make sure everything is up-to-date

  • Go to Exetensions > Extension Manager
  • Make sure that all your extensions are up-to-date
  • Make sure you're running the latest version of Joomla 2.5. At the time of this writing, it's Joomla 2.5.8.

3) Check your system for Joomla 3 compatibility

media_1357676707825.png

At the time of this writing, Joomla does not have a pre-upgrade check yet, however it's an upcoming feature that will be added soon. Until then, you must check things manually.

  • Go to Site, then System Information.
  • Check all your settings from within this tab and compare them to the required/recommended settings at https://www.joomla.org/technical-requirements.html
  • If your site meets all the requirements, you are ready to update.
media_1357676886754.png

 

4) Check your extensions for Joomla 3 compatibility

There will also be a custom extension check in the new pre-upgrade check; However, until then, you need to check with your extension developers' sites, documentation, and/or support as to whether the extensions are Joomla 3 compatible. This step includes your template(s) as well.

5) Create a test site

Once you're sure that all your extensions are compatible, create another backup and a test site on the same server in a subfolder (be sure to create a copy of the database and not use the same one). You can use our Create a Joomla Test Site Using Akeeba Backup tutorial for that part.

6) Test the upgrade in the test site

  • Go to Components, then Joomla! Update 
  • Click the Options button
media_1357677991511.png
  • Change the Update Server to Short Term Support
  • Click Save & Close
media_1357678238704.png
  • Finally, on the test site, click the "Install the update". If all goes well, then you can do the same steps on the live site.
media_1357678432435.png
  • Note: if the "Install the update" doesn't appear right away, you may need to go to Extensions (top menu) >> Extension Manager (sub menu) >> Update (tab) >> Purge Cache (button - far right).
  • Note: after upgrading, check in Extensions (top menu) >> Extension Manager (sub menu) >> Database (side menu) and make sure there are no errors. If there are some, click on fix button.

Enjoy your new Joomla 3 site!

 

Start a FREE 7 day trial! Get training videos and books, plus expert support:  

License

All of our tutorials are published under the Creative Commons Attribution-NonCommercial license. This means:
  • You can re-use these tutorials.
  • You can modify these tutorials.
  • You must link back to our original tutorial.
  • You can't use these tutorials commercially.
Click here to read the full license.