Internet-in-a-Box (IIAB) 8.1 pre-releases are thoroughly tested, and can be installed from this page! Please read our DRAFT IIAB 8.1 Release Notes.

To install IIAB 8.1 onto Raspberry Pi OS, Ubuntu 22.04+, Linux Mint 21+ or Debian 11+, simply run this 1-line installer:

curl | bash

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 not only more reliable, but also allows an internal IIAB hotspot to be set up without confusion. WARNING: IF YOU CONNECT YOUR IIAB'S INTERNAL WIFI 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).

Thanks For Building Your Own Library To Serve One & All

Please contact us if you find issues, Thank You! Special Thanks to the countries + communities + volunteers working non-stop to bring about IIAB 8.1 !

IIAB Dev Team
http://FAQ.IIAB.IO Raspberry Pi Prefab Images

Raspberry Pi Prefab Images

For information on the installation process please see IIAB Installation.

You can also install from scratch, which takes about an hour using scripts like load.txt.

Target Platforms

The images provided will work for Raspberry Pi 2, 3, Zero, and Zero W.


Download an image, unzip it, and write it to an SD card of 8GB or higher.

(it may not fit on all 8 GB cards and you will want a larger card if you plan to add content)

WARNING: Be very careful writing an image to an SD card that you USE THE CORRECT DEVICE, to avoid accidentally overwriting 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. On Linux or MacOS, use tools like dd, unzip and xz.

Resizing the Image

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.


Keep in mind that an image is a snapshot in time, lacking recent security fixes. You should probably do the following:


Change the root and pi password.

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 iiab-admin with default password g0adm1n.

iiab-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.

Real Time Clock

If your RPi will operate with no internet connection, an RTC can be benefial.

These images are preconfigured for the DS3231 found on and other places.

If you have no RTC or another incompatible one, please edit /opt/iiab/iiab/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.

Types of Images

Pixel Lite Image Details based upon 2017-07-05 Pixel Lite.

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 iiab-admin / g0adm1n was performed.

The following services were selected, saved, and Install Configured Options clicked:

You are now ready for Adding Content.

You can also access the Admin Console to select additional features for your server.