Migrating from Joomla 1.5 to Joomla 2.5

This article provide the step to step to guide you migrate from Joomla 1.5 to Joomla 2.5

Before start, we strongly recommend backup your Joomla. From this article, we recommend user use jUpgrade to upgrade Joomla 1.5 to Joomla 2.5.

Review the Requirement

Please review the technical requirement for Joomla! 2.5.

Before You Get Started
Before you get started, there are a few things that you are going to have to check and/or think about:

  1. Is your Joomla 1.5 version is up to date? The most up-to-date version of Joomla is 1.5.26. If your version is not up-to-date, upgrade to 1.5.26 before migrating. Read how to download older releases of Joomla!. You will need the Joomla! 1.5.0 to Joomla! 1.5.26 package with file name: Joomla_1.5.0_to_1.5.26-Stable-Patch _Package.zip. Read here how to get a latest Joomla version.
  2. Do all your extensions have Joomla 2.5 native versions? You can use Advanced Search on the Joomla! Extensions Directory to see what extensions support 2.5. Please note that jUpgrade is not currently able to upgrade all Joomla 3rd party extensions, so those will have to be done via their respective upgrade procedures. Supported by jUpgrade on January 2012 are AdminPraise, Kunena, K2, JoomComment, Virtuemart, redSHOP, CommunityBuilder, JCE, Contact Enhanced, JomSocial, redForm, JEvents, Akeeba Backup, Jumi and redMEMBER.
  3. Have you modified any core files? Any changes that you have made to core files in Joomla will be lost so please be forewarned.
  4. Is there a Joomla 2.5 compatible template available from your template provider? If not, do you feel comfortable making the changes yourself? 
  5. Do you have folder or file permissions issues in your Joomla 1.5 installation?

Backup Your Joomla

Please always backup your site before perform upgrading. If you have backup it always save your time if revert is needed.

Using XCloner to Backup

  • With XCloner you can backup your site fully, both files and database.
  • XCloner will produce TAR archives which can opened with most archive clients
  • After creating the backup, they can easily be restored by using its dedicated restore script
  • XCloner can be downloaded for free from http://www.xcloner.com, a full documentation usage wiki is here: http://www.xcloner.com/wiki/index.php/Main_Page
Using Akeeba to Backup
  • Akeeba Backup produces a .jpa file
  • The .jpa file contains all the folders and files and the MySQL database of your site
  • The .jpa file also contains an installer
  • Kickstart.php (also from Akeeba) unpacks the .jpa file and then runs the installer
Akeeba and Kickstart can be downloaded from Joomla extenstion directory. There is a link to full instruction as well.

Upgrading with jUpgrade

Always download latest version of jUpgrade. It is highly advisable, especially when development still is progressing, to always use the latest available version!
Download here!

Install JUpgrade

Login to your Joomla dashboard (backend). e.g. www.yourdomain.com/administrator

Access to Extension > Install/Uninstall

Browse > Select com_jupgrade > Upload File & Install

Enable Mootools Upgrade Plugin
  1. Go to Extension > Plugin Manager
  2. Search for "System - Mootools Upgrade"
  3. Enable the plugin

It is important that this plugin is installed and that it has been set to enabled, as the proper functioning of jUpgrade depends on it.

Configure the Options

As of jUpgrade version 2.5, support is present is migrate to Joomla! 1.7 and Joomla! 2.5. Configure the options by navigating to Administrator > Components > jUpgrade > Parameters.


  • Distribution - Select whether to migrate to Joomla! 1.6 or 2.5.
  • Prefix for old database - Your current table prefix.
  • Prefix for new database - Your selected table prefix for your migrated site
  • Skip checks - Skip pre-migration checks
  • Skip download - Skip downloading the package (Note: Must have a package already downloaded to your temp folder or set this and Skip Decompress if set to Yes)
  • Skip decompress - Site decompressing the downloaded package package (Note: Must have a package already downloaded and decompressed to site_root/jupgrade if set to Yes)
  • Keep original positions - Keep the currently defined positions for modules.
  • Enable Debug - Enable this to have messages displayed below the migration process concerning the progress, helpful if having issues

Save the Options when finished.


Components > Upgrade

Start Upgrade

Do not exit the screen until everything has finished loading. Scroll down to check if finished.

* Note: Please note that jUpgrade currently does not migrate custom and add-on templates. Only the default templates are initially installed. You must manually migrate the other templated.

Behind the Scenes

Even if the migration process was not 100% successful, your Joomla 1.5 is still intact and none of your users are affected. You have an opportunity to check out your site both in the frontend and the backend to make sure everything is working.

So what actually happens? jUpgrade downloads the version of Joomla that you selected to the jupgrade directory (which it creates) in the root folder of your Joomla 1.5 installation. It then extracts all the files from the download. Once extraction has completed, jUpgrade installs the new Joomla version and then migrates your old database to the new database which it has created. Your new site will be installed in www.yourdomain.com/jupgrade assuming that your Joomla 1.5 installation is in your html root.

Check Your New Joomla! Installation

Please do a full site review of your new Joomla installation and make sure everything is set up properly. Your new Joomla site will be installed in www.yourdomain.com/jupgrade assuming that your Joomla 1.5 installation is in your html root. Here is a general checklist:
  • Banners
  • Categories
  • Contacts
  • Content
  • Menus
  • Modules
  • Newfeeds
  • Users


Work is currently being done on the template upgrade feature of jUpdate and it is not yet fully functional. Your module positions may have to be adjusted in the module manager.

If you had custom templates or templates other than those installed as defaults, they may have been copied from your version 1.5 files. If so, they now must be upgraded or modified and then Discovered.

Backup Joomla!

If everything looks good to go, backup the new Joomla Installation.

Overview of the Rest of the Process

Quick overview of what we are going to try to do now:

Relocate our Joomla 1.5 installation to a subfolder as a "just in case".
  1. Relocate our new Joomla installation to the html folder.
  2. Relocate our new Joomla installation to the html folder.
'It should happen in this order' If you do it in reverse order, the new Joomla files will get mixed with the Joomla 1.5 files (many of 1.5 files will be overwritten) and you will have a big mess! Your site will likely still work, but it's a security ticking time bomb waiting to go off.

Going Live

Next log onto your host's file manager (e.g. cPanel, WebSitePanel or HELM) or an FTP Client, however, preferably a file manager. The general procedure is (it should take about 30 seconds if you review the steps before you start):

  1. Create a subfolder (e.g. myoldsite) for the Joomla 1.5 installation in your html root, e.g. public_html/myoldsite
  2. Select all the folders (***except the jupgrade folder***) and files in the html root and move them into the Joomla 1.5 subfolder (e.g. myoldsite)
  3. Select all the folders and files in the jupgrade folder and move them to the html root
  4. Double check the frontend and backend

Done. Kindly enjoy your new Joomla!2.5.

Add Feedback