Admin tools ::: tool_moodlebox
Maintained by Nicolas Martignoni
A Moodle administration plugin providing a GUI to some settings and management of a MoodleBox, a Moodle server installed on a Raspberry Pi with some sort of Linux version installed (Raspberry Pi OS preferred).

MoodleBox 1.12.2

Moodle 3.4, 3.5, 3.6
Released: Saturday, December 1, 2018, 10:45 PM

MoodleBox Moodle plugin

Build Status GitHub release GitHub Release Date GitHub last commit

A Moodle administration plugin providing a GUI to some settings and management of a MoodleBox, a Moodle server installed on a Raspberry Pi.

This plugin enables a Moodle administrator to monitor some hardware settings, to set the date of the MoodleBox, to allow restart and shutdown of the MoodleBox and changing Raspberry Pi passwords using a GUI. After the installation in Moodle, some steps are required to complete on the Raspberry Pi (see below).

The plugin is compatible with Moodle 3.3 or later. A Raspberry Pi model 3B or 3B+ is recommended.


The MoodleBox plugin must be installed in the Moodle tree of the MoodleBox, in the tool folder. Once installed, an new option MoodleBox will be available in Moodle, under Site administration > Server in the Administration block.

To complete the installation, you have to configure some incron jobs on the MoodleBox.

  1. Install incron package and allow root to run it:

    sudo apt-get install incron
    echo root | sudo tee -a /etc/incron.allow
  2. Add following lines to incrontab:

    /var/www/moodle/admin/tool/moodlebox/.reboot-server IN_CLOSE_WRITE /sbin/shutdown -r now
    /var/www/moodle/admin/tool/moodlebox/.shutdown-server IN_CLOSE_WRITE /sbin/shutdown -h now
    /var/www/moodle/admin/tool/moodlebox/.set-server-datetime IN_CLOSE_WRITE /bin/bash /var/www/moodle/admin/tool/moodlebox/.set-server-datetime
    /var/www/moodle/admin/tool/moodlebox/.newpassword IN_CLOSE_WRITE /bin/bash /var/www/moodle/admin/tool/moodlebox/bin/
    /var/www/moodle/admin/tool/moodlebox/.wifisettings IN_CLOSE_WRITE /bin/bash /var/www/moodle/admin/tool/moodlebox/bin/
    /var/www/moodle/admin/tool/moodlebox/.resize-partition IN_CLOSE_WRITE /bin/bash /var/www/moodle/admin/tool/moodlebox/bin/
  3. Copy the following line at the end of file /etc/sudoers:

    www-data ALL=(ALL) NOPASSWD:/sbin/parted /dev/mmcblk0 unit MB print free


  • Info about the MoodleBox (kernel version, Raspbian version, free space on SD card, CPU load, CPU temperature, CPU frequency, uptime, DHCP clients).
  • GUI to set the MoodleBox date and time.
  • GUI to set the MoodleBox password.
  • GUI to set the MoodleBox Wi-Fi network password (or remove it), SSID and channel.
  • GUI to resize the partition of the SD card of the MoodleBox.
  • GUI to restart and shutdown the MoodleBox.


The code is available at

Release notes

See Release notes.


Copyright © 2016 onwards, Nicolas Martignoni

  • All the source code is licensed under GPL 3 or any later version
  • The documentation is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Version information

Version build number
Version release name
Can be updated from
1.10, 1.10.1, 1.10.2, 1.10.3, 1.10.4, 1.11.0, 1.12.0, 1.12.1
Can be updated to
2.0.0, 2.0.1, 2.1.0, 2.2.0, 2.2.1, 2.3.0, 2.4.0, 2.4.1, 2.4.2 (2019100700), 2.5.0 (2020020800), 2.6.0 (2020060800), 2.7.0 (2020072300), 2.9.0 (2021022100)
Stable version
MD5 Sum
Supported software
PHP 7.0, PHP 7.1, Moodle 3.4, PHP 7.2, Moodle 3.5, Moodle 3.6
  • Latest release for Moodle 3.4
  • Latest release for Moodle 3.5
  • The more recent release 2.10.0 (2021072700) exists for Moodle 3.6

Version control information

Version control system (VCS)
VCS repository URL
VCS tag

Default installation instructions for plugins of the type Admin tools

  1. Make sure you have all the required versions.
  2. Download and unpack the module.
  3. Place the folder (eg "mytool") in the "admin/tool" subdirectory.
  4. Visit to finish the installation