If you want to quickly install Internet-in-a-Box (IIAB) onto a Raspberry Pi, please start by reading IIAB Images for Raspberry Pi.

(The instructions below supplement the above, if you need help installing Raspberry Pi Imager.)

On Windows, Ubuntu for x86, or macOS:

1. Browse to: https://www.raspberrypi.com/software/
2. Download Raspberry Pi Imager for your OS.
3. Open the downloaded file and install it.
4. Raspberry Pi Imager needs to be run in a special way — so that you can write IIAB onto a microSD card — please follow the precise instructions below for your OS!

On Raspberry Pi OS with desktop, the above browser/downloading steps aren't necessary: proceed to the Linux section below.

1. In File Manager, double-click the downloaded file (e.g. imager-1.9.0.exe) to install it.

2. Raspberry Pi Imager should now be in your Windows Start menu. However you need to launch it in a different way — so proceed to Step 3.

3. Run this command:

   rpi-imager --repo http://iiab.io/fast.json
   

   If the above fails, try this: (make sure to include the quotes!)

   "C:\Program Files (x86)\Raspberry Pi Imager\rpi-imager.exe" --repo http://iiab.io/fast.json
   

1. Open a command-line Terminal.
2. If your OS is Raspberry Pi OS with desktop, run sudo apt install rpi-imager (this will install or upgrade Raspberry Pi Imager). Proceed to Step 4.
3. If your OS is Ubuntu for x86 (Desktop version), then download and run:

   ./Raspberry_Pi_Imager-1.9.0-x86_64.AppImage    # ADJUST VERSION NUMBER AS NECESSARY!
   

4. Arrange for it to be installed at /usr/bin/rpi-imager (create a symlink if absolutely necessary).
5. Run this command:

   sudo rpi-imager --repo http://iiab.io/fast.json
   

1. Open the downloaded file (e.g. Raspberry.Pi.Imager-1.9.0.dmg) in Finder by double clicking on it.
2. Drag rpi-imager into the Applications folder (macOS convention).
3. Run these 2 commands in a Terminal window: (BACKGROUND: Terminal.app should be in Applications > Utilities — if you want to use it often, drag Terminal.app to the menu bar at the top of your screen)

   sudo echo "open /Applications/Raspberry\ Pi\ Imager.app/ --args --repo http://iiab.io/fast.json" > /usr/local/bin/iiab-imager
   sudo chmod 755 /usr/local/bin/iiab-imager
   

4. Open a Terminal and run this command: iiab-imager

[Obsolete explanation from mid-2020...explains how we got here:]

There are 3 .json files that make this work. They are...

• images.json (sourced from os_list_imagingutility.json)

...and its 2 "child" .json files:

• os_list_imagingutility_iiab_subitems.json
• os_list_imagingutility_iiab_experimental.json

The "parent" (images.json, sourced from os_list_imagingutility.json) only needs to be re-generated if the Raspberry Pi Foundation publishes new images.

The two "child" .json files must be re-generated every time IIAB publishes a new image, using techniques outlined here: (e.g. this happens every few of months, typically soon after an IIAB release)

• #2446
• PR iiab/iiab-factory#113
• github.com/iiab/iiab-factory/tree/master/box/rpi/iiab-imager/

[Dec 2021 / Feb 2022...simplification:]

• #3060
• PR iiab/iiab-factory#199
• PR iiab/iiab-factory#206
• github.com/iiab/iiab-factory/tree/master/box/rpi/
• downloads.raspberrypi.org/os_list_imagingutility.json [Last modified 2021-05-28]
• downloads.raspberrypi.org/os_list_imagingutility_v2.json [Last modified 2021-02-03]
• downloads.raspberrypi.org/os_list_imagingutility_v3.json [Last modified 2021-02-03]