Skip to content

moodlebox/elimupi

Folders and files

NameName
Last commit message
Last commit date
Mar 31, 2023
Mar 7, 2022
Jan 11, 2023
Nov 26, 2018
Apr 5, 2023

Repository files navigation

ElimuPi Connect

The purpose of this project is to provide a DEAN communication environment for educational project in Tanzania and Kenya. This includes providing internet connectivity and software defined networks.

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

Introduction

This version of the ElimuPi-Connect build supports:

  • Web pages for management of the system and content management (WordPress).
  • Secured WiFi Access Point.
  • Local DHCP, DNS.

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 -p ./roles -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 2.8GB gzipped 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: elimuconnect using passcode: 1234567890
  • Point your browser to http://connect.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

No end users can access the ElimuPi Connect.

The following links are provided to access the resources:

After you finished the installation you need to visit connect.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: September 6th 2022. on a Raspberry Pi model 4.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Jinja 67.1%
  • JavaScript 25.3%
  • Shell 3.8%
  • Perl 3.8%