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

How to Get Started -- Create Imager on a USB Stick

• Download the most recent IMAGER [confusing as filenames do not contain "IMAGER"] from http://download.iiab.io/packages/imager/. Depending on the speed of your internet, this could take a while.
• On Windows:
  • [Delete this paragraph to make life easier for teachers?] After the download completes, on Windows, use the filemanager to find the downloaded file, right click on the < filename >.img.zip file, and select "extract all files".
  • Use https://etcher.io or https://sourceforge.net/projects/win32diskimager/ to write the downloaded image file to a USB stick (all data will be lost)
• On a MAC:
  • IMAGER has not yet been verified to function correctly on a MAC.

Boot IMAGER on your Windows machine

• On Windows:
  • Make sure that your BIOS is set to boot first from USB -- setting the BIOS may require that you strike the F1, F2, F10, F12, or Delete key just after turning on the power.
  • Look for a BIOS setting called "boot options" or "boot order".
  • Put the USB stick into the machine, and turn on the power.
• On a MAC:
  • Hold down the "option" key, during the power-on sequence.
• After a short time you should see the colorful boot process of Tiny Core Linux, and eventually the IMAGER menu as shown at https://github.com/georgejhunt/iiab-factory/tree/fixes/box/rpi/imager/docs/USAGE.md.