Note: You are currently viewing documentation for Moodle 2.5. Up-to-date documentation for the latest stable version of Moodle may be available here: Upgrade overview.

Moodle 2
available now!

Step 1: Server check
Step 2: Backup
Step 3: Get new code

There’s no need to visit a store and pay for software. You can start enjoying the cool features of Moodle 2 in three easy steps...

Step 1: Make sure that your server can run Moodle 2.2

(Note: You need to upgrade to Moodle 2.2 before upgrading to 2.3.)

Go to Settings > Site administration > Server > Environment

Status OK for everything? Great! Go to step 2...

Any problems? You probably need to upgrade your server software (such as PHP) to a more recent version.

Step 2: Be prepared for failure

As usual with any large upgrade, you should always be prepared to "roll back" if there's an issue with your data or some custom code you've added.

A test install
We highly advise you make a copy of your production site to practice the upgrade on first. That way, if you run into any problems that need fixing you won't affect your main site.
Always make backups
When upgrading your production instance, make sure you have copies of everything, just in case. Full instructions are here: Site backup.

Step 3: Replace your old Moodle code with new Moodle 2.2 code

To upgrade Moodle all you need to do is replace the code and then run the upgrade scripts.

Small site
Instructions here: Installing the new Moodle software
Large site?
Instructions here: Upgrading via command line

Success?

Yes - it worked!
Great! Repeat the process for Moodle 2.3, and please post in the Installation problems forum and share your success with the Moodle community!
No - I had an error
Don’t worry, help is at hand. Post in the Installation problems forum where our experts are waiting to explain any errors you obtain.