Repository files navigation

A Moodle server and Wi-Fi router on Raspberry Pi.

Visit theMoodleBox web site for more information about the MoodleBox features or any question about the usage of a MoodleBox.

If you just want to use a MoodleBox, justinstall it with Raspberry Pi Imager on your Raspberry Pi Zero 2 W, 3A, 3B, 3B+, 4B, 400 or 5 and use it out of the box. Follow the instructions on theMoodleBox web site.

We have an activediscussion forum where users and developers can ask questions. Please don't use the GitHub issue tracker to ask questions.

If you just want to use a MoodleBox,you don't need to build the MoodleBox disk image yourself. Justinstall it with Raspberry Pi Imager on your Raspberry Pi Zero 2 W, 3A, 3B, 3B+, 4B, 400 or 5 and use it out of the box. Follow the instructions on theMoodleBox web site.

To build a MoodleBox from scratch with this script, you need a Raspberry Pi 3B, 3B+, 4B or 5.

1. CloneRaspberry Pi OS (64-bit) Lite image on your microSD card.
2. Create assh.txt file on thebootfs partition with any content.
3. Create auserconf.txt file on thebootfs partition, and add the following line to it:moodlebox:$6$rmLgDblolU16oLmc$i7QzARV8o84tCDQA/Kq1xU3eYwPWlocqVmpFTcSWqAqiWJpFyTLd.g9W5ktDDh16rq5lwYG9wpHY224m5nHLk0
4. Insert the microSD card into your Raspberry Pi.
5. Connect your Raspberry Pi to your Ethernet network and boot it.
6. Install Ansible on your computer. On macOS, use e.g.brew install ansible.
7. Installsshpass to enable passing SSH password to the Raspberry Pi. On macOS, use e.g.brew tap esolitos/ipa; brew install sshpass.
8. Clone this repository to your local drive.
9. Create akeys directory in the repository folder and copy your public key into it, under the nameid_rsa.pub.
10. Get the IP address of your Raspberry Pi and change it in thehosts.yml file. Do not change anything else, unless you know what you're doing. You're on your own.
11. Runansible-playbook moodlebox.yml from the repository folder.
12. Wait 15–50 minutes, depending on your Raspberry Pi model, SD card speed and Internet bandwidth. You're done.

You can override any of the defaults configured indefault.config.yml by creating aconfig.yml file and setting the overrides in that file. For example, you can change the MoodleBox main credentials and the timezone with something like:

moodlebox_username: 'myusername'moodlebox_password: 'secret'moodlebox_timezone: 'Australia/Perth'

Any variable can be overridden inconfig.yml; see the filedefault.config.yml for a list of available variables.

The code is available athttps://github.com/moodlebox/moodlebox.

SeeRelease notes.

MoodleBox is sponsored byE-learning Touch' Moodle Partner.

• To Daniel Méthot, for theidea of a MoodleBox
• To Christian Westphal, for thefirst POC of a MoodleBox
• To theRaspberry Pi Foundation, for a splendid small computer
• ToMartin Dougiamas, for giving us Moodle, and to theMoodle community

Copyright © 2016 onwards, Nicolas Martignoninicolas@martignoni.net.

All contributions to this repository are licensed under AGPLv3 or any later version.

MoodleBox doesn't require a CLA (Contributor License Agreement). The copyright belongs to all the individual contributors. Therefore we recommend that every contributor adds following line to the header of a file, if theychanged it substantially:

@copyright Copyright © <year>, <your name> (<your email address>)