IanseoBox is a Ubuntu ARM-64 Architecture Linux Image built by DHUNY Riyad for Raspberry Pi with a Ianseo inside.IanseoBox uses the Wi-Fi of the Raspberry Pi to create an Access Point.
When deployed, IanseoBox makes it easy for archers to use with Ianseo Scorekeeper.
Visit the Ianseo web site for more information about ianseo features or any question about the usage of a Ianseo.
If you just want to use a IanseoBox, a prepared disk image of the latest released version is available for downloading and using out of the box on your Raspberry Pi 3A, 3B, 3B+ or 4B. Follow the instructions on the ianseoBox web site.
Please don't use the GitHub issue tracker to ask questions.
If you just want to use a IanseoBox, you don't need to build the IanseoBox disk image yourself. Just download the IanseoBox image and follow the instructions on the IanseoBox web site.
To build a IanseoBox from scratch with this script, you need a Raspberry Pi 3B, 3B+ or 4B.
-
Clone Ubuntu ARM-64 on your microSD card.
-
Insert the microSD card into your Raspberry Pi.
-
Connect your Raspberry Pi to your Ethernet network and boot it.
-
Login with username
ubuntu
passwordubuntu
. Set new password toIanseobox4$
. -
Create a
ssh.txt
file on theboot
partition, e.g. usingsudo touch /boot/ssh.txt
-
Install Ansible on your computer.
-
Install
sshpass
to enable passing SSH password to the Raspberry Pi. On macOS, use e.g.brew tap esolitos/ipa; brew install sshpass
.sudo apt install sshpass ansible unzip -y
-
Clone this repository to your local drive.
-
A server restart may be required for apt update & upgrade to remove locks on tmp files. Perform
sudo apt update && sudo apt upgrade -y
-
Create a
keys
directory in the repository folder and copy your public key into it, under the nameid_rsa.pub
. -
A quick way for above is:
ssh-keygen -t rsa
with blanks as defaults.
sudo cp /home/ubuntu/.ssh/id_rsa.pub /home/ubuntu/IanseoBox/keys/
-
Get the IP address of your Raspberry Pi and change it in the
hosts.yml
file. Do not change anything else, unless you know what you're doing. You're on your own. -
Create a config.yml with
cp default.config.yml config.yml
. -
Run
ansible-playbook ubuntu.yml
from the repository folder to prepare the OS. -
Wait 1 -2 mins, playbook will change username from ubuntu to moodlebox, script will exit with failure.
-
Playbook will stop after username change, with an error similar to
Unable to create local directories(/home/ubuntu/.ansible/cp’
... -
Reboot server with sudo init 6 and login with username ianseobox password Ianseobox4$
-
Run
ansible-playbook ianseobox.yml
from the repository folder. -
Wait 15–50 minutes, depending on your Raspberry Pi model, SD card speed and Internet bandwidth. You're done.
-
If the script fails at adminer, run the ianseobox.yml script again.
-
On first boot run passwd and change the default password. Delete the Install folder from the root directory.
-
Set your default Country Code by typing sudo nano /etc/hostapd/hostapd.conf.
You can override any of the defaults configured in default.config.yml
by creating a config.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: 'Indian/Mauritius'
Any variable can be overridden in config.yml
; see the file default.config.yml
for a list of available variables.
The Ianseobox code is available at https://github.com/dhuny/ianseobox.
See Original Ianseobox Release notes.
Credits to: Nicolas Martignoni, Daniel Méthot and Christian Westphal for their original work on Moodlebox.
Credits to Ardingo Scarzella, Andrea Gabard, Christian Deligant, Matteo Pisani and Marco Carpignano for this IANSEO software.
- To Nicolas Martignoni, the maintainer of Moodlebox. IanseoBox concept originates from moodlebox and Martignoni's work.
- To Daniel Méthot, for the idea of a MoodleBox
- To Christian Westphal, for the first POC of a MoodleBox
- To the Raspberry Pi Foundation, for a splendid small computer
- To Ardingo Scarzella, Andrea Gabard, Christian Deligant, Matteo Pisani and Marco Carpignano, for giving us IANSEO.
The original Ianseobox copyright info is as follow:
Copyright © 2020 onwards, DHUNY Riyad, riyad@dhuny.org.
All contributions to this repository are licensed under AGPLv3 or any later version.
IanseoBox 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 they changed it substantially:
@copyright Copyright © <year>, <your name> (<your email address>)