Skip to content

DEAN-ngo/elimupi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ElimuPi

The purpose of this project is to provide a DEAN digital classroom environment for educational project in Tanzania and Kenya. This includes providing full Android tablet support without any direct internet connectivity.

Please visit https://www.dean.ngo/solutions/elimupi/ for more information.

Introduction

This version of the ElimuPi build supports:

  • F-Droid an Android application store.
  • Web pages for management of the system and content management (WordPress).
  • WiKiPedia alike functions based on Kiwix.
  • Kolibri learning system.
  • Dynamic content addition through USB storage.
  • Secured WiFi Access Point.
  • Wifi client support that defaults connects to AP's: elimupi-connect or dean-4g.
  • Local DHCP, DNS.
  • Scratch, a high-level block-based visual programming language.
  • Beamer support via onboard micro HDMI

Installation

Prerequisites:

Install Raspberry Pi OS

When the image has been successfully written insert the SD-card into the Raspberry Pi and boot the device connected to local LAN.

Build ElimuPi Image

Provision the ElimuPi software by running the ansible-play book against local Raspberry Pi and build Elimupi the image.

  • Find the Pi's assigned IP address on your local LAN. ( via Wifi router or a nmap).
  • Git clone this repo and cd elimupi/ansible directory of this repo.
  • Adjust the current IP adresss of key : ansible_host in file inventory.yml to your Pi's local assigned IP address.
  • Increment version release number variable, elimupi_release: in file ansible/group_vars/all/vars.yml if needed.
  • Install Ansible collections:

ansible-galaxy collection install -r collections.yml

  • Install Ansible roles.

ansible-galaxy install -r roles.yml

  • Run playbook

ansible-playbook -i ./inventory.yml playbook-raspberrypi.yml --ask-vault-pass

The installation will take approximately 20 minutes to finish and there shouldn't be any errors.

Create ElimuPi image copy

This should produce a xz compressed Elimupi image file.

The image file can than be directly written to other SD-cards using Raspberry Pi Imager selecting the image with Use Custom Operation System option.

Connecting to Elimupi

  • Disconnect the Raspberry PI's TCP wired connection.
  • Connect your device via WiFi to SSID: elimu using passcode: 1234567890
  • Point your browser to http://start.elimupi.online

Default users

All default username and passwords will be pi/elimupi unless noted differently.

The default password for the Wifi AP with SSID: 'elimu' is : 1234567890

User access

The end users can access the available resources after they are connected to the Wifi network.

The following links are provided to access the resources:

After you finished the installation you need to visit admin.elimupi.online login with the Admin account and go to Manage --> "Please follow the directions to register your device, so that it can synchronize with the central server."

Notes

NOTE1: This install is tested to work with Raspberry Pi OS Lite 64 bits image , Release date: March 15th 2024. on a Raspberry Pi model 5.