1
0
mirror of https://github.com/billz/raspap-webgui.git synced 2023-10-10 13:37:24 +02:00

Updated Captive portal setup (markdown)

Bill Zimmerman 2020-02-11 13:19:55 +01:00
parent db143ae9ca
commit 291155fb24

@ -1,6 +1,6 @@
The [nodogsplash project](https://github.com/nodogsplash/nodogsplash) is a lightweight, highly configurable captive portal solution. It integrates nicely with RaspAP and is recommended over other methods. No configuration changes are needed with RaspAP, however you will need to modify some default settings in the nodogsplash config. This step-by-step guide assumes you have already installed RaspAP, either with the [Quick Installer](https://github.com/billz/raspap-webgui/wiki/Quick-Installer-usage) or [manual setup instructions](https://github.com/billz/raspap-webgui/wiki/Manual-installation). The [nodogsplash project](https://github.com/nodogsplash/nodogsplash) is a lightweight, highly configurable captive portal solution. It integrates nicely with RaspAP and is recommended over other methods. No configuration changes are needed with RaspAP, however you will need to modify some default settings in the nodogsplash config. This step-by-step guide assumes you have already installed RaspAP, either with the [Quick Installer](https://github.com/billz/raspap-webgui/wiki/Quick-Installer-usage) or [manual setup instructions](https://github.com/billz/raspap-webgui/wiki/Manual-installation).
1. Begin by updating `apt` with the latest package information: 1. Begin by updating your RPi with the latest package information:
``` ```
sudo apt-get update sudo apt-get update
``` ```
@ -10,7 +10,7 @@ sudo apt-get update
sudo apt-get install libmicrohttpd-dev sudo apt-get install libmicrohttpd-dev
``` ```
3. Next, we will clone the nodogsplash GitHub repository: 3. Next, clone the nodogsplash GitHub repository:
``` ```
cd ~ cd ~
git clone https://github.com/nodogsplash/nodogsplash.git git clone https://github.com/nodogsplash/nodogsplash.git
@ -23,7 +23,7 @@ make
sudo make install sudo make install
``` ```
5. With nodogsplash installed in the system, we will make some small changes to its configuration. The nodogsplash GatewayInterface should be set to the interface RaspAP runs on (wlan0 is the default). You will also need to change the GateWayAddress to 10.3.141.1. 5. With nodogsplash installed in the system, we will make two small changes to its configuration. The nodogsplash GatewayInterface should be set to the interface RaspAP runs on (wlan0 is the default). You will also need to change the GateWayAddress to 10.3.141.1.
``` ```
sudo nano /etc/nodogsplash/nodogsplash.conf sudo nano /etc/nodogsplash/nodogsplash.conf
@ -50,7 +50,7 @@ GatewayAddress 10.3.141.1
``` ```
Save and quit out of the editor by pressing **Ctrl+X** and then pressing **Y** and finally **Enter**. Save and quit out of the editor by pressing **Ctrl+X** and then pressing **Y** and finally **Enter**.
6. We are now ready to start up the software. This can be done by simply executing the binary with `sudo nodogsplash`. However, we'll make things a bit easier by adding a `systemd` service provided by the project. Copy the following file and enable the service: 6. We are now ready to start up the software. This can be done by simply executing the binary with `sudo nodogsplash`. However, we'll make things a bit easier by adding a `systemd` service provided by the project. Copy the service control file and enable it:
``` ```
sudo cp ~/nodogsplash/debian/nodogsplash.service /lib/systemd/system/ sudo cp ~/nodogsplash/debian/nodogsplash.service /lib/systemd/system/
sudo systemctl enable nodogsplash.service sudo systemctl enable nodogsplash.service