To install IIAB 8.2 onto Raspberry Pi OS, Ubuntu 24.04+, Linux Mint 22+ or Debian 12+, simply run this 1-line installer:
On a Raspberry Pi, WE RECOMMEND YOU INSTALL THE LATEST RASPBERRY PI OS (64-bit is recommended), using their detailed instructions if necessary. WARNING: THE NOOBS OS IS *NOT* SUPPORTED, as its partitioning is very different. To attempt an IIAB install onto a non-supported Linux distribution (AT YOUR OWN RISK) see also the manual/legacy instructions.
An Ethernet cable is highly recommended during installation. This is more reliable AND allows an internal IIAB hotspot to be set up without confusion. WARNING: IF YOU CONNECT YOUR IIAB'S INTERNAL WI-FI TO THE INTERNET OVER 5 GHz, YOU'LL PREVENT OLDER LAPTOPS/PHONES/TABLETS (WHICH REQUIRE 2.4 GHz) FROM CONNECTING TO YOUR IIAB'S INTERNAL HOTSPOT. For AP+STA mode, set "wifi_up_down: True" in /etc/iiab/local_vars.yml (example).
Please contact us if you find issues, Thank You! Special Thanks to the countries + communities + volunteers working non-stop to bring about IIAB 8.2 !
IIAB Dev Team
http://FAQ.IIAB.IO
For information on the overall Internet-in-a-Box installation process please see IIAB Installation.
If you prefer to do everything yourself, please read the far longer instructions to install from Scratch, using rpi-load.txt instead of an install image.
The install images will work on Raspberry Pi 2 and 3.
Download an image, unzip it, and write it to an SD card that is 8 GB or larger.
(actual size varies, so it may not fit on all 8 GB cards and you will want a larger card if you plan to add content)
In general choose the latest date for any given type of image.
WARNING: Be very careful writing an image to an SD card that you USE THE CORRECT DEVICE.
You could overwrite your hard disk.
To write to an SD card in Linux or MacOS issue the command (you may need to do sudo):
To write an unzipped image to an SD card in Windows, use the Win32 Disk Imager application to write to the Drive Letter of your device.
The first time you boot the image it should automatically resize the root file system to the capacity of the SD card.
You can cause this to run again by issuing the command touch /.resize-rootfs
If this does not work for some reason you can ssh into the RPi and use the raspi-config utility.
As with any downloaded image, it's generally best to get any recent fixes. Keep in mind that an image is a snapshot at some point in time. You should probably do the following:
Change the root and pi passwords.
Please note that on some of the images this has already been done.
Also, please note that after running runansible, you will not be able to ssh in as root anymore. You will have to login as xsce-admin with default password g0adm1n.
xsce-admin is a sudoer, so you will still have root privileges.
N.B: Some images may have authorized public keys for people who can offer support. Please remove them from root's .ssh directory if you do not want to permit this access. (Use "rm -f /home/root/.ssh/authorized_keys"). Read more about security precautions you can take.
If your RPi is intended to operate away from the internet, it needs a RTC.
These images are preconfigured for the DS3231 found on Amazon.com and other places.
If you have another incompatible RTC or none at all, please edit /opt/schoolserver/xsce/vars/local_vars.yml and change rtc_id to your model or 'none'.
You may also need to install additional drivers or otherwise change the 1-prep/tasks/raspberry_pi_2.yml playbook.
These images are meant for 'headless' servers and have no graphical shell. Access is via ssh or the Admin Console.
These images have a graphical shell and may serve as a desktop as well as a server.
This image is built on Raspbian Lite. The unzipped image is 8.4 GB and so requires a 16 GB SD card minimum. The steps up to and including ./runansible have already been performed in this image.
An initial configuration was performed following configuration.
Networking was set up as follows:
The Admin Console at http://box.lan/admin was accessed in a browser and login with xsce-admin/g0adm1n was performed.
The following services were selected, saved, and Install Configured Options clicked:
You are now ready to Add Content.
You can also access the Admin Console to select additional features for your server.
This image is built on Raspbian Pixel. The unzipped image is 18.3 GB and so requires a 32 GB SD card minimum. The steps up to and including ./runansible have already been performed in this image.
An initial configuration was performed following configuration.
Networking was set up as follows:
The Admin Console at http://box.lan/admin was accessed in a browser and login with xsce-admin/g0adm1n was performed.
The following services were selected, saved, and Install Configured Options clicked: