Skip to content

Commit 6552b92

Browse files
authored
Switch to Ubuntu (not server)
1 parent 1f53f91 commit 6552b92

File tree

1 file changed

+34
-12
lines changed

1 file changed

+34
-12
lines changed

iiab-setup/iiab-on-ubuntu.md

Lines changed: 34 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -17,29 +17,51 @@ These instructions describe how to install [Internet in a Box](https://internet-
1717
* [Windows](https://ubuntu.com/tutorials/create-a-usb-stick-on-windows)
1818
* [Linux](https://ubuntu.com/tutorials/create-a-usb-stick-on-ubuntu)
1919
* [MacOS](https://ubuntu.com/tutorials/create-a-usb-stick-on-macos)
20-
* Install Ubuntu Server. Additional instructions [here](https://ubuntu.com/tutorials/install-ubuntu-desktop)
20+
* Install Ubuntu. Additional instructions [here](https://ubuntu.com/tutorials/install-ubuntu-desktop)
2121
* Can be installed in English or other language appropriate for the target environment
22-
* When creating a user account, be sure to grant Administrator permissions. Remember the username/password, as these credentials will be needed later to install IIAB.
2322

24-
### 2. Download Internet in a Box
23+
### 2. Additional Ubuntu Setup
24+
* After initial Ubuntu set up is complete, connect to the Internet via ethernet or WiFi before proceeding.
25+
* Update any outdated packages:
26+
```
27+
sudo apt-get update && sudo apt-get upgrade
28+
```
2529

26-
* Login to Ubuntu Server
27-
* Open a Terminal using any of these methods:
28-
* Connect to the Ubuntu Server from a different computer via [SSH](https://help.ubuntu.com/community/SSH/OpenSSH/ConnectingTo)
29-
* or, when logged into graphical user interface: `Ctrl + Shift + T`
30-
* or, when logged into graphical user interface: Right-click the desktop, choose
30+
* Install some packages we'll need later:
31+
```
32+
sudo apt-get install openssh-server net-tools curl
33+
```
34+
* In order to connect to this host from another computer via SSH, install/enable SSH and get its IP address. Open a terminal (`Crtl + Shift + T`):
35+
```
36+
# Install open-ssh and net-tools
37+
sudo apt-get install openssh-server net-tools
38+
39+
# Enable ssh server
40+
sudo systemctl enable ssh --now
41+
42+
# Start ssh server
43+
sudo systemctl start ssh
44+
45+
# Get IP address
46+
hostname -I
47+
```
48+
49+
### 3. Download Internet in a Box
50+
51+
* Login to Ubuntu
52+
* Open a Terminal session via SSH or `Ctrl + Shift + T` on the desktop
3153
* Follow the instructions in https://github.com/iiab/iiab/wiki to install IIAB
3254
* `curl d.iiab.io/install.txt | sudo bash`
3355
* IIAB Setup Options:
3456
* iiab-admin password: `g0adm1n`
3557
* Choose **1 - MIN-sized**
58+
* Follow prompts to update packages and reboot
59+
* Re-run `sudo iiab` after reboot
3660

37-
----
38-
39-
### 3. Add IIAB Configuration Preset
61+
### 4. Add IIAB Configuration Preset
4062

4163
* Select a preset configuration from here (TBD)
42-
* Create a directory on the Ubuntu server to hold the preset files. For example, if your preset is "MyIIAB2022":
64+
* Create a directory to hold the preset files. For example, if your preset name is "MyIIAB2022":
4365
* `mkdir /opt/admin/cmdsrv/presets/MyIIAB2022/`
4466
* `cp` the contents of the presets directory in this folder
4567
* Using a browser connect to http:/box/admin over the hotspot or http:/<server ip>/admin on your lan

0 commit comments

Comments
 (0)