diff --git a/FAQs.md b/FAQs.md index 0c4545b..3cd409d 100644 --- a/FAQs.md +++ b/FAQs.md @@ -6,6 +6,7 @@ This has been written to address some frequently encountered issues among users * [RaspAP control panel works but there is no WiFi after reboot](#nowifi) * [AP is not visible or can't connect to SSID with the Pi Zero](#pizero) * [How do I integrate RaspAP with Pi-hole?](#pihole) +* [Can I configure RaspAP to work with a captive portal?](#captive) ### My custom rc.local/networking configuration/wpa configuration is gone! Currently, RaspAP generates a few of its own files so that it starts with a known configuration. Your custom configurations haven't been lost however, they've been moved to the backups directory in `/etc/raspap/backups`. @@ -77,3 +78,54 @@ Follow these steps in the order below: ([source](https://discourse.pi-hole.net/t/raspap-pihole/14739/7)) +### Can I configure RaspAP to work with a captive portal? +Yes, the [nodogsplash project](https://github.com/nodogsplash/nodogsplash) works just fine with RaspAP and is recommended over other methods. No configuration changes are needed with raspap-webgui, however you will need to modify some default settings in the nodogsplash config. + +The nodogsplash `GatewayInterface` should be set to the interface RaspAP runs on (`wlan0` is used by the Quick Installer). You will also need to change the `GateWayAddress` to `10.3.141.1`. + +` sudo vim /etc/nodogsplash/nodogsplash.conf` + +```# Parameter: GatewayInterface +# Default: NONE +# +# GatewayInterface is not autodetected, has no default, and must be set here. +# Set GatewayInterface to the interface on your router +# that is to be managed by Nodogsplash. +# Typically br-lan for the wired and wireless lan. +# +GatewayInterface wlan0 +``` + +``` +# Parameter: GatewayAddress +# Default: Discovered from GatewayInterface +# +# This should be autodetected on an OpenWRT system, but if not: +# Set GatewayAddress to the IP address of the router on +# the GatewayInterface. This is the address that the Nodogsplash +# server listens on. +# +GatewayAddress 10.3.141.1 +``` + +Give the nodogsplash service a kick: + +`sudo systemctl restart nodogsplash` + +...and verify that the service is running: + +`sudo systemctl status nodogsplash` + +```● nodogsplash.service - NoDogSplash Captive Portal + Loaded: loaded (/lib/systemd/system/nodogsplash.service; enabled; vendor preset: enabled) + Active: active (running) since Sat 2019-03-02 07:55:11 UTC; 11min ago + Process: 3404 ExecStart=/usr/bin/nodogsplash -d 5 $OPTIONS (code=exited, status=0/SUCCESS) + Main PID: 3405 (nodogsplash) + CGroup: /system.slice/nodogsplash.service + └─3405 /usr/bin/nodogsplash -d 5 +``` + +Point your browser to http://10.3.141.1 and you should see the default nodogsplash page. + +![image](https://i.imgur.com/arTZmii.jpg) +