Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Upgrading FAQ.
How do I upgrade from 1.9.x to 3.1?
1.x -> 1.9.19+ -> 2.2.11 -> 2.7.20 -> 3.1
(It is better to upgrade to latest current stable before going to next branch, the same for plugins; upgrading from early stable branches usually works but there is no guarantee.)
Legacy versions such as 1.9.19+, 2.2.11 and 2.7.20 may be downloaded from https://download.moodle.org/releases/legacy/
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 3.1 from Moodle 2.7.
You can only upgrade to Moodle 2.7 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 for some suggestions.
- Installation FAQ
- Using Moodle Notes on upgrading Moodle from 1.9.x to 2.4.1 on a shared server forum discussion