mirror of
https://github.com/iiab/iiab.git
synced 2025-02-12 19:22:24 +00:00
26 lines
2 KiB
ReStructuredText
26 lines
2 KiB
ReStructuredText
==============
|
|
Network README
|
|
==============
|
|
|
|
This is run by `Ansible <https://wiki.iiab.io/go/FAQ#What_is_Ansible_and_what_version_should_I_use%3F>`_ after it has installed the core (`Stages 0-to-9 <https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible>`_) of `Internet-in-a-Box (IIAB) <https://internet-in-a-box.org>`_ and its apps/services.
|
|
|
|
Specifically, this 'network' role is run...
|
|
|
|
- ...automatically during IIAB installation, after `/opt/iiab/iiab/iiab-install <../../iiab-install>`_ has run `Stages 0-to-9 <..>`_ (thanks to `iiab-stages.yml <../../iiab-stages.yml>`_).
|
|
- ...automatically by IIAB's **Admin Console** (http://box/admin) if you click **Configure** -> **Install Configured Options** — this is similar to the above, but only runs Stage 0, then Stage 4-to-9, and then finally this 'network' role/stage (thanks to `iiab-from-console.yml <../../iiab-from-console.yml>`_).
|
|
- ...or manually, if you run `sudo iiab-network <../../scripts/iiab-network>`_
|
|
- A stronger version is also available if necessary: ``cd /opt/iiab/iiab`` then ``sudo ./runrole --reinstall network``
|
|
- If your IIAB was installed prior to August 2022, instead run: ``cd /opt/iiab/iiab`` then `sudo ./iiab-network <../../iiab-network>`_ (which is much the same as running ``sudo ./runrole network``).
|
|
|
|
Many IIAB networking questions can be answered in these 2 documents:
|
|
|
|
- `IIAB Networking <https://github.com/iiab/iiab/wiki/IIAB-Networking>`_ is a high-level summary, that reviews IIAB's 3 modes of operation distinguishing WAN from LAN, `common ports <https://github.com/iiab/iiab/wiki/IIAB-Networking#list-of-ports--services>`_, DNS name resolution and some common customizations.
|
|
- http://FAQ.IIAB.IO includes answers to common questions like:
|
|
|
|
- What is local_vars.yml and how do I customize it?
|
|
- How do I provide Wi-Fi (wireless) to all my kids?
|
|
- Can I create a Wi-Fi hotspot using an old laptop?
|
|
- How do I change the wireless network name?
|
|
- Can I name my server something other than http://BOX.LAN ?
|
|
- How do I set a static IP Address?
|
|
- Any other networking tips?
|