How to update Moodle

Warning

Before updating your version of Moodle, make sure that the server requirements are met on your MoodleBox. To do this, log in to Moodle, visit Site Administration > Server > Environment, click on Update component, then check that no line says Check in red.

Warnings site not https and php not 64 bits are not a problem and can be ignored.

To update Moodle, perform the following operations, using the command line.

First log into the MoodleBox via SSH, with the main password. If you didn’t change it yet, use the default main password Moodlebox4$.

ssh moodlebox@moodlebox.home

Update to a minor version

To update to the next minor version of Moodle (3.9.1, 3.9.2, etc.), type the following commands in the terminal:1

cd /var/www/moodle/
sudo -u moodlebox -g www-data git pull

Visit then in your browser the URL http://moodlebox.home/admin and follow the update instructions, like any Moodle installation (read the documentation).

Update to a major version

To update to the next major version of Moodle (4.0, 4.1, etc.), type the commands above, then the additional following commands:

sudo -u moodlebox -g www-data git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
sudo -u moodlebox -g www-data git fetch origin
sudo -u moodlebox -g www-data git checkout MOODLE_40_STABLE

Then visit the URL http://moodlebox.home/admin and follow the update instructions, like any Moodle installation (read the documentation).

Tip

If you have a MoodleBox version 2.5.0 and earlier, use sudo -u www-data git ... instead of sudo -u moodlebox -g www-data git ... in the all the commands above.


  1. In order to allow a simplified update of Moodle, its installation was done using Git. ↩︎