/iiab-factory

Tim’s unofficial toolkit for deploying IIAB. It might, for example, have an install script that installs ansible and git if needed, clones IIAB, copies a particular local_vars.yml to IIAB, runs the IIAB install, and then clones other repos like iiab-admin-console and iiab-menu and installs them.

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

<!-- For http://d.iiab.io/README.html -- usable in version subdirectories too -->
<!-- Copied from https://github.com/iiab/iiab-factory/blob/master/README.html -->

<pre>
Internet-in-a-Box (IIAB) 7.2 pre-releases can be installed from this page.

Please read our DRAFT <a href="https://github.com/iiab/iiab/wiki/IIAB-7.2-Release-Notes">IIAB 7.2 Release Notes</a>.  To install IIAB 7.2 onto
<a href="https://www.raspberrypi.org/downloads/raspberry-pi-os/">Raspberry Pi OS</a>, <a href="https://github.com/iiab/iiab/wiki/IIAB-Platforms#operating-systems">Ubuntu 20.04</a>, <a href="https://linuxmint.com/rel_ulyana_cinnamon.php">Linux Mint 20</a> or <a href="https://www.debian.org/releases/buster/debian-installer/">Debian 10</a>, run this
1-line installer:

               curl <a href="http://d.iiab.io/install.txt">d.iiab.io/install.txt</a> | sudo bash

OS TIPS & TRICKS: click the above link (that ends in .txt) for important
recommendations on how to PREPARE & SECURE YOUR OS.

WARNING: NOOBS IS *NOT* SUPPORTED, as its partitioning is very different.
On a Raspberry Pi, <a href="https://www.raspberrypi.org/documentation/installation/installing-images/README.md">WE RECOMMEND YOU INSTALL THE LATEST RASPBERRY PI OS</a>.
To attempt IIAB 7.2 on <a href=https://github.com/iiab/iiab/wiki/IIAB-Platforms#operating-systems>another Linux</a> see the <a href="https://github.com/iiab/iiab/wiki/IIAB-Installation#do-everything-from-scratch">full/manual instructions</a>.

An Ethernet cable is HIGHLY RECOMMENDED during installation, as this is more
reliable than Wi-Fi (and faster too!)  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.  See: "wifi_up_down: True" in /etc/iiab/local_vars.yml<!--  If however you must install over Wi-Fi,
remember to run "iiab-hotspot-on" after IIAB installation, TO ACTIVATE YOUR
RASPBERRY PI's INTERNAL WIFI HOTSPOT (thereby killing Internet connectivity!)-->

        Thanks For Building Your Own Library To Serve One & All

Write to bugs @ iiab.io if you find issues, Thank You!  Special Thanks to the
countries+communities+volunteers working non-stop to bring about <a href="http://wiki.laptop.org/go/IIAB/7.2">IIAB 7.2</a>!

IIAB Development Team
<a href="http://FAQ.IIAB.IO">http://FAQ.IIAB.IO</a>
</pre>