Countless hours have been spent by many volunteers from around the world to put Joomla 1.6 together. Although much of the code is the same from Joomla 1.5, much of it has been written from the ground up, and the changes are comparable to the changes from Joomla 1.0 to 1.5.

Because the changes from Joomla 1.5 to 1.6 are so large and because of the massive effort put into getting Joomla 1.6 to where it is today, there is no core upgrade path, this is indeed a migration.

In planned future releases of Joomla (which will be released every 6 months), the changes from version to version will be more incremental and a core upgrade path is planned. Now that Joomla 1.6 is finally here and stable, a community initiative led by the developers of Joomla is turning towards jUpgrade (a 3rd party Joomla extension on the JED originally developed by Matias Aguirre) for help and to help.

Many of Joomla's developers (who are all volunteers that freely contribute their time) are volunteering to put the finishing touches on jUpgrade.

jUpgrade allows you to migrate from Joomla 1.5 to 1.6.

Lets get started!

Please, please save yourself (and possibly your clients) a lot of headaches and make sure that your server (and in the case of jUpgrade, your browser too) is up for the task.

The system requirements of Joomla 1.6 can be found here:
https://www.joomla.org/technical-requirements.html

jUpgrade requirements can be found here:
https://www.matware.com.ar/joomla/jupgrade.html

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

Is your Joomla 1.5 version up to date? At the time of the writing of this tutorial the most up-to-date version of Joomla 1.5 is 1.5.22. Much of the testing of the migration has been done from Joomla 1.5.22 to Joomla 1.6. If your version is not up-to-date you should probably upgrade to 1.5.25, which is now the latest version, before migrating, especially if you are running Joomla 1.5.11 or lower. For a tutorial on upgrading, please visit this link.

Do all your extensions have Joomla 1.6 native versions? At the time of the writing of this tutorial there are 108 available on the JED. Please note that jUpgrade is not currently able to upgrade Joomla 3rd party extensions, so those will have to be done via their respective upgrade procedures. This is however a work in progress. Because of the transition period, the modules may be flagged for use with 1.6 or 1.7. These will still work with 1.6. Watch for more upgrades as 1.6 matures.

Have you modified any core files? Any changes that you have made to core files in Joomla will be lost so please be forewarned.

Is there a Joomla 1.6 compatible template available from your template provider? If not, do you feel comfortable making the changes yourself? There are a some good resources including Chad Windnagle's Joomla Community blog, Chris Davenport's "Template Changes for Joomla 1.6" presentation and the Joomla docs. Please note that although jUpgrade is not able to currently upgrade templates, the developers are working hard at implementing the feature.

Is your language pack available in Joomla 1.6? https://community.joomla.org/translations/joomla-16-translations.html

Do you have folder or file permissions issues in your Joomla 1.5 installation? https://www.ostraining.com/blog/joomla/admin-tools-the-quick-and-easy-way-to-change-folder-and-file-permissions/

Do you NEED to migrate to Joomla 1.6? Joomla 1.5 is powerful and very mature. For many people there is not a need to rush into Joomla 1.6. Joomla will continue to support Joomla 1.5 for at least another three months, releasing security updates and bug squashing updates when needed.

The two main features of Joomla 1.6 that make it superior to Joomla 1.5 are: Access Control List (ACL) and nested categories. Gone are the days of simply having guests, registered users, authors, and editors, without being able to specify what they can and can't do in the frontend. Also, with 1.6 you can have more flexibility of organizing (and therefore displaying) your content with nicely organized categories within categories. No more being restricted to the section >> category structure. Those are all great things to have (especially the ACL), however, for many 1.5 users, it isn't needed. The main point is to decide for yourself:

• For an overview of Joomla 1.6 in video format, please see: https://www.ostraining.com/blog/joomla/three-new-joomla-16-overview-videos-including-acl/
• For a massive list of changes from Joomla 1.5 to Joomla 1.6, please see: https://docs.joomla.org/What%27s_new_in_Joomla_1.6 which was the first implementation of the new features.
• Check out the newest features of 1.6 in 25 Improvements in Joomla 1.6
• For a great blog on whether or not to migrate, please see: https://www.rockettheme.com/blog/joomla/988-should-i-upgrade-to-joomla-16

Skipping this part is perhaps the biggest mistake you can make. If you have a proper backup (or several) you can always revert back if needed. However, if you don't properly backup your site and something goes wrong, you are going to waste a lot of valuable time, and sometimes a lot money, getting things back to the way they were. So please backup!

If you don't know how, please see steps 1 through 5 in this tutorial.

Download the latest version of jUpgrade. Start at the Joomla Extensions Directory listing. In January 2012, the most curent version is jUpgrade v1.2.4

If you are really nervous by this point and your heart is beating fast, then you should probably set up a testing environment. You can follow this tutorial to make a copy of your site to test on your localhost or another remote server.

Go to your Joomla backend. e.g. www.example.com/administrator

Extensions >> Install/Uninstall

Browse >> Select com_jupgrade >> Upload File & Install

Components >> jUpgrade

Start Upgrade

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

Success!!!

As explained in the background information, the changes from Joomla 1.5 and 1.6 are quite significant. The fact that jUpgrade creates a new Joomla 1.6 installation for us is, in my opinion, pure genius. If the migration process was not 100% successful, your Joomla 1.5 is still perfectly 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 up to par.

So what actually happens? jUpgrade downloads the latest version of Joomla 1.6 for you 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 Joomla 1.6 and then proceeds to migrate your old database to the new Joomla 1.6 database which it has created.

Your Joomla 1.6 site will be installed in www.example.com/jupgrade assuming that your Joomla 1.5 installation is in your html root.

Please do a full site review of your Joomla 1.6 installation and make sure everything is set up properly.

Your Joomla 1.6 site will be installed in www.example.com/jupgrade assuming that your Joomla 1.5 installation is in your html root.

Here is a general checklist of items to test:

• Banners
• Categories
• Contacts
• Content
• Menus
• Modules
• Newsfeeds
• Users
• Weblinks
• Templates - 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 module manager.

If everything looks good to go, then let's backup the new Joomla 1.6 installation. You can follow this tutorial: https://www.ostraining.com/blog/joomla/how-to-backup-a-joomla-16-site/

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

1. Relocate our Joomla 1.5 installation to a subfolder as a "just in case".
2. Relocate our Joomla 1.6 installation to the html folder.

*****It should happen in this order***** If you do it in reverse order, the Joomla 1.6 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.

Next log onto your host's file manager (e.g. cPanel, Plesk, etc) 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

You can use this tutorial to guide you through the process.

1. jUpgrade cannot download Joomla 1.6 package? When the download fails (timeouts, javascript issues, etc) you can download it manually here and put this file into your ROOT/tmp directory. Then, in the preferences of jUpgrade, you must set 'Skip Download' to 'Yes'. After that, run the upgrade again.
2. Progress Bar? Are you getting errors with the progress bar in Internet Explorer (Windows XP)? Use Firefox.
3. Read Carefully: Please go through the Requirements and Before You Get Started sections above and double check everything!
4. Report Bugs: https://redcomponent.com/forum/92-jupgrade
5. Get Support: https://redcomponent.com/forum/92-jupgrade

Creating an extension as significant as jUpgrade requires an enormous amount of time and effort considering the major structural changes between Joomla 1.5 and 1.6. Add to this the fact that starting with release of Joomla 1.6 betas, the extension would have to be modified to work with the new changes between releases, and all of a sudden it's too hard for any one person to complete in a short period of time (especially when you are not being paid).

With this being said, it's time to step up and make a difference, whether big or small. Have you profited from Joomla in the last year? Are you excited about the future of Joomla? Would you like to contribute back and show your gratitude? Now you can in this project!

We, as part of the Joomla community, are calling on the entire Joomla community to help out in whatever way you can. You don't have to be a master developer, just go through this tutorial on a test site and if you come across any bugs, report it. If you know how to fix it, create a patch for it. If you are a master developer, step up to the challenge.

You can report bugs here: https://redcomponent.com/forum/92-jupgrade

You can volunteer and ask questions about volunteering here: https://www.matware.com.ar/forum/projects/jupgrade/volunteer-information.html

If you have additions, suggestions, corrections for this tutorial you can either post it in the comments or use our contact page, and we will modify it as necessary. This tutorial will continually be getting updated as we get new information.