Note: You are currently viewing documentation for Moodle 2.6. Up-to-date documentation for the latest stable version of Moodle may be available here: Upgrading FAQ.

Upgrading FAQ

From MoodleDocs
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

How do I upgrade from 1.9.x to 2.6?

1.x -> 1.9.19 -> 2.2.11 -> 2.6

(It is better to upgrade to latest current stable before going to next branch, the same for add-on plugins; upgrading from early stable branches usually works but there is no guarantee.)

How do I upgrade Moodle? Do I just overwrite the files?

Do NOT overwrite files, as it may cause strange errors. Read the Upgrading documentation before proceeding.

I obtain the message "Upgrade already running in this session, please wait!"

Most likely you refreshed the page before the completion message. If you are absolutely sure that there are no upgrade processes active (php and/or mysql), you can click on "!!!" and restart the upgrade.

Note: If you click on "'!!!" or try to restart the upgrade from another browser, there is a chance that your data in the database could be corrupted. If this happens, you will need to restore the database from sql dump and then restart the upgrade and wait - the process can take several hours on large sites.

Can I upgrade more than one version at a time?

You can only upgrade to Moodle 2.6 from Moodle 2.2.

You can only upgrade to Moodle 2.2 from Moodle 1.9 or later.

For information on upgrading from versions of Moodle prior to 1.9, see the section 'Upgrading more than one version' in the Moodle 2.2 documentation Upgrading.

I have custom code in my site. How do I upgrade?

Please see this forum post on upgrading with custom code

See also