This is a guide for anyone initializing an EMURR unit before being sent to end users.
- On a machine that can read to an SD card, natively or through an extension cable, install the Raspberry Pi Imager (https://www.raspberrypi.com/software/)
- Select Raspberry Pi OS (Other) > Raspberry Pi OS Lite
- Update the configs with the gear icon (bottom-right):
- Check
select hostname
and enter emurr. This should now read emurr.local - Check
enable password authentication
- Check
set username and password
and enterusername:
to emurr andpassword:
to a secure password you are comfortable entering through SSH. - Enter
set locale settings
appropriate for the end user
- Check
- Select the SD card from
Choose Storage
- Wait for the download to complete. This may take a while. Feel free to move to the next section while waiting.
-
Power on the router
-
Configure via Web Browser GUI. Connect to the router via Wi-Fi or Ethernet following the steps shown below.
-
After you log in, follow the step for the Quick Setup
-
Select time zone
-
Select Internet Connection Type (Auto Detect). Since the router will not be connected to the internet, leave it as default and proceed to the next step.
-
Customize Wi-Fi network
- Enable 2.4GHz & 5GHZ Wireless
- Define Network Name (SSID).
- Set up a password (optional). Current Wi-Fi networks are open.
-
Test the setup by connecting the computer to the created Wi-Fi network and logging back into the browser GUI.
-
-
Connect RPi to the router using an Ethernet cable. Note that the DHCP Server will assign a random IP address to the RPi and other devices connected to it.
-
Set up address reservation (fixed IP address) for RPi
- Go to Advanced > Network > DHCP Server
- In the DHCP Client List, find the current IP address of the RPi or open a terminal in the RPi and type
ifconfig
. You will get something like this:
eth0 is the LAN (wired) interface.
- IP address is squared in red
- MAC address in squared in blue
- In the Address Reservation section, click Add and enter the desire IP address and MAC address of the RPi and save the settings.
-
Gather Hardware:
- SD Card w/ Pi OS
- Power Cable
- Ethernet Cable
- Peripherals (as needed)
- Your Raspberry Pi
-
Connect to Pi (SSH or Peripherals)
SSH
- Power the Pi and connect ethernet to the same network as the device performing SSH
NOTE ON USING ENTERPRISE NETWORKS:
You cannot use enterprise networks such as UCF WPA or eduroam. The Raspberry Pi, even with significant edits to the config files cannot reliably connect to such networks. Trust us, we've tried. - SSH to the Pi with
ssh [email protected]
If this step does not work:
Get the Pi's IP address by pingingping emurr.local
If this still does not work:
- Ensure the Imager was configured with a proper
hostname
- Ensure you are not on an enterprise network
- Alternatively, you may want to do this step only after you have set up the router and established a static IP address
- Ensure the Imager was configured with a proper
- Enter password as specified in your Pi Imager configuration
Peripherals
- Power the Pi and connect peripherals (HDMI, Desktop, & USB Keyboard)
- Login with the password specified in your Pi Imager configuration
- Power the Pi and connect ethernet to the same network as the device performing SSH
-
Install & Initialize NGINX
- Install NGINX on the Raspberry Pi by running
sudo apt-get install nginx
- Start the NGINX server with
sudo systemctl start nginx
You may verify NGINX status with
sudo systemctl status nginx
For more help visit NGNIX docs here:
> https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-open-source/#installing-prebuilt-debian-packages
- Install NGINX on the Raspberry Pi by running
-
Update the folders on the Raspberry Pi as instructed for each of these folders on this repository
rpi/root/
The contents of this folder should be unloaded to the root~/
directoryrpi/html/
The contents of this folder should be unloaded to the/var/www/html
directoryrpi/nginx-config/
The contents of this folder should replace the nginx configs/etc/nginx/sites-available/default
file