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

Updated FAQs (markdown)

Bill Zimmerman 2019-04-13 16:34:28 +02:00
parent 67f381a8d6
commit a875c2b8b8

21
FAQs.md

@ -4,11 +4,11 @@ This has been written to address some frequently encountered issues among users
* [How do I remove RaspAP?](#uninstall) * [How do I remove RaspAP?](#uninstall)
* [What are the steps to upgrade RaspAP?](#upgrade) * [What are the steps to upgrade RaspAP?](#upgrade)
* [RaspAP control panel works but there is no WiFi after reboot](#nowifi) * [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) * [How do I integrate RaspAP with Pi-hole?](#pihole)
* [Can I configure RaspAP to work with a captive portal?](#captive) * [Can I configure RaspAP to work with a captive portal?](#captive)
* [Why can't I access wireless mode 'N' (802.11n)?](#wireless-mode) * [Why can't I access wireless mode 'N' (802.11n)?](#wireless-mode)
* [How do I prepare the SD card to connect to WiFi in headless mode?](#headless-mode) * [How do I prepare the SD card to connect to WiFi in headless mode?](#headless-mode)
* [Can I use wlan0 and wlan1 rather than eth0 for my AP?](#interfaces)
### <a name="custom"></a>My custom rc.local/networking configuration/wpa configuration is gone! ### <a name="custom"></a>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`. 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`.
@ -64,9 +64,6 @@ add the following line at the end of the file
``` ```
**note:** replace `10.3.141.254` with a device IP on your network. (other than 10.3.141.1). The only downside of this method is that no matter the device is offline or unreachable, this script will execute at startup. But it's not that noticeable. **note:** replace `10.3.141.254` with a device IP on your network. (other than 10.3.141.1). The only downside of this method is that no matter the device is offline or unreachable, this script will execute at startup. But it's not that noticeable.
### <a name="pizero"></a>AP is not visible or can't connect to SSID with the Pi Zero
Extra steps are needed to configure the Pi Zero that are not provided by the RaspAP Quick Installer or manual setup instructions. [@hallard](https://github.com/hallard) has [documented the process](https://github.com/ch2i/LoraGW-Setup/blob/master/doc/AccessPoint.md) with Raspbian Stretch.
### <a name="pihole"></a>How do I integrate RaspAP with Pi-hole? ### <a name="pihole"></a>How do I integrate RaspAP with Pi-hole?
[Pi-hole®](https://github.com/pi-hole/pi-hole) is a popular RPi-based project that blocks ads network-wide by creating a DNS sinkhole. There have been several discussions around integrating RaspAP with Pi-hole, with the end goal of hosting a complete AP and ad-blocker on a single device. This is possible with a few modifications, essentially giving permission to Pi-Hole to manage `dnsmasq` leases. [Pi-hole®](https://github.com/pi-hole/pi-hole) is a popular RPi-based project that blocks ads network-wide by creating a DNS sinkhole. There have been several discussions around integrating RaspAP with Pi-hole, with the end goal of hosting a complete AP and ad-blocker on a single device. This is possible with a few modifications, essentially giving permission to Pi-Hole to manage `dnsmasq` leases.
@ -80,6 +77,8 @@ Follow these steps in the order below:
([source](https://discourse.pi-hole.net/t/raspap-pihole/14739/7)) ([source](https://discourse.pi-hole.net/t/raspap-pihole/14739/7))
Please note: Pi-hole integration is not officially supported by this project. Therefore, bug reports will not be addressed.
### <a name="captive"></a>Can I configure RaspAP to work with a captive portal? ### <a name="captive"></a>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. 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.
@ -162,3 +161,17 @@ network={
key_mgmt=WPA-PSK key_mgmt=WPA-PSK
} }
``` ```
### <a name="interfaces"></a>Can I use wlan0 and wlan1 rather than eth0 for my AP?
The short answer is yes. In this scenario, you may wish to use the built-in wlan0 interface with a USB wlan1 connection, rather than wired ethernet (eth0). This is partly supported by RaspAP, although you will need to make two small updates.
Changing the following setting in `includes/config.php` to `wlan1`:
```
define('RASPI_WIFI_CLIENT_INTERFACE', 'wlan1')
```
...add the following to `/etc/dhcpcd.conf`:
```
nohook wpa_supplicant
```
...and finally restart hostapd.