Change the domain name of the MoodleBox


The operations described on this page may render your MoodleBox unusable, requiring the complete wiping of the SD card and the loss of all data (course contents, installed plug-ins, custom configurations, etc.). Do this only if you know exactly what you are doing. In any case, no support is provided on this subject.

We accept no responsibility for any direct or indirect damage caused by the use of the MoodleBox, in particular following a change of domain name.

How to proceed

The instructions below shows how to change the domain name of a MoodleBox, which will allow a local device to reach it with a new URL. The example shows how to give the MoodleBox the domain name


This operation has no influence on access to the MoodleBox from an Ethernet network or from the Internet: the MoodleBox will remain accessible only from the Wi-Fi network it provides, from the devices that have connected to it.

Step 1: Change the host name (hostname)

In the last line of the /etc/hosts file, replace moodlebox with

In the /etc/hostname file, replace moodlebox with (this modification is not necessary, but highly recommended).

Step 2: Adapt the configuration of the nginx web server

In the file /etc/nginx/sites-available/default, replace moodlebox with the full domain name (FQDN) in the server_name directive.

Step 3: Adapt the DNS server masquerading configuration

In the file /etc/NetworkManager/dnsmasq-shared.d/00-dhcp.conf, replace home by in the two lines that start with domain and local.

If your domain name is a public one, comment out or delete completely the line starting with address. Otherwise, if your new domain name will remain local, ending with .home, you can keep this line untouched.

Step 4: Adapt the captive portal configuration (Nodogsplash)

In the file /etc/nodogsplash/nodogsplash.conf, replace the URL http://moodlebox.home/ by

Step 5: Adapt the Moodle configuration (Moodle URL)

In the file /var/www/moodle/config.php, on the line beginning with $CFG->wwwroot, replace the URL http://moodlebox.home by Do not add a slash at the end of the URL.

Step 6: Restart the MoodleBox

In order to apply these changes, restart your MoodleBox.

Step 7: Replace Moodle URLs

Access your MoodleBox through your browser using the new address and use the URL replacement tool at to replace URLs in the Moodle database.

Step 8: Replace SSL certificates (optional)

If you want to use HTTPS, you’ll have to get your own SSL certificates, as those provided by the MoodleBox won’t work with your custom domain name Don’t forget to change the URL too.