frodovdr/raspap-webgui
1
0
Fork 0
mirror of https://github.com/billz/raspap-webgui.git synced 2023-10-10 13:37:24 +02:00
Code Issues Releases Wiki Activity

Updated FAQs (markdown)

Bill Zimmerman 2020-04-08 11:51:54 +02:00
parent ea2456e3a5
commit 5414e16621
1 changed files with 7 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
FAQs.md

@ -1,7 +1,7 @@
This has been written to address some frequently asked questions among users of RaspAP. This has been written to address some frequently asked questions among users of RaspAP.
* [What do all these settings in the UI do? Changing them seems to have no effect.](#settings) * [What do all these settings in the UI do? Changing them seems to have no effect.](#settings)
* [My custom rc.local/networking configuration/wpa configuration is gone!](#custom) * [My custom `hostapd.conf` / `php.ini` is gone. Help!](#custom)
* [I changed the admin password and forgot what it was. Help!](#password) * [I changed the admin password and forgot what it was. Help!](#password)
* [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)
@ -33,10 +33,10 @@ For example, two of the best starting points for understanding `hostapd` (the se
**Important:** After you choose **Save settings** for `hostapd` or `dhcpcd`, these services _must_ be stopped and restarted for your changes to take effect. If you're not sure if your AP is behaving as expected, enable logging in the **Advanced** options of **Configure hotspot** and check the output. **Important:** After you choose **Save settings** for `hostapd` or `dhcpcd`, these services _must_ be stopped and restarted for your changes to take effect. If you're not sure if your AP is behaving as expected, enable logging in the **Advanced** options of **Configure hotspot** and check the output.
## <a name="custom"></a>My custom rc.local/networking configuration/wpa configuration is gone! ## <a name="custom"></a>My custom `hostapd.conf` / `php.ini` is gone. Help!
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`. The [installer](https://github.com/billz/raspap-webgui/wiki/Quick-Installer-usage) applies a "known good" default configuration to some services, including `hostapd`. It will also, optionally, optimize php by changing a very limited number of settings. Your custom configurations haven't been lost however; they've been moved to the backups directory in `/etc/raspap/backups`.
Feel free to SSH in to restore those files to their rightful position, however, you may need to ensure that the RaspAP modifications are applied to your own custom configurations. You are free to SSH in to restore those files to their rightful position. However, you may need to ensure that the RaspAP modifications are applied to your own custom configurations.
## <a name="password"></a>I changed the admin password and forgot what it was. Help! ## <a name="password"></a>I changed the admin password and forgot what it was. Help!
Login credentials are stored in `/etc/raspap/raspap.auth`. The password is encrypted and cannot be edited manually. However, deleting this file with `sudo rm /etc/raspap/raspap.auth` will restore the default admin password. Login credentials are stored in `/etc/raspap/raspap.auth`. The password is encrypted and cannot be edited manually. However, deleting this file with `sudo rm /etc/raspap/raspap.auth` will restore the default admin password.
@ -194,7 +194,7 @@ sudo systemctl restart lighttpd.service
You can then access RaspAP as before with the new port number in the URI, for example, http://raspberrypi.local:8080. This will allow you run another web server alongside lighttpd, if that is your goal. You can then access RaspAP as before with the new port number in the URI, for example, http://raspberrypi.local:8080. This will allow you run another web server alongside lighttpd, if that is your goal.
## <a name="dnsmasq"></a> Can I use RaspAP with my custom dnsmasq configuration? ## <a name="dnsmasq"></a> Can I use RaspAP with my custom dnsmasq configuration?
Yes, RaspAP supports this through the use of `dnsmasq.d`. The primary `dnsmasq.conf` managed by the UI includes the following directive to enable your custom .conf files: Yes, RaspAP supports this through the use of `dnsmasq.d`. The primary `/etc/dnsmasq.d/090_raspap.conf` managed by the UI includes the following directive to enable your custom .conf files:
``` ```
conf-dir=/etc/dnsmasq.d conf-dir=/etc/dnsmasq.d
@ -202,7 +202,6 @@ conf-dir=/etc/dnsmasq.d
Configuration files placed in this directory will be used by the dnsmasq service and are untouched by the UI. Configuration files placed in this directory will be used by the dnsmasq service and are untouched by the UI.
## <a name="openvpn"></a> OpenVPN fails to start and/or I have no internet. Help! ## <a name="openvpn"></a> OpenVPN fails to start and/or I have no internet. Help!
RaspAP supports OpenVPN clients by uploading a valid .ovpn file to `/etc/openvpn/client` and, optionally, creating a `login.conf` file with your client auth credentials. Additionally, in line with the project's [default configuration](https://github.com/billz/raspap-webgui/wiki/Reporting-issues#default-settings), the following iptables rules are added to forward traffic from OpenVPN's `tun0` interface to your configured wireless interface (`wlan0` is the default): RaspAP supports OpenVPN clients by uploading a valid .ovpn file to `/etc/openvpn/client` and, optionally, creating a `login.conf` file with your client auth credentials. Additionally, in line with the project's [default configuration](https://github.com/billz/raspap-webgui/wiki/Reporting-issues#default-settings), the following iptables rules are added to forward traffic from OpenVPN's `tun0` interface to your configured wireless interface (`wlan0` is the default):
@ -250,7 +249,7 @@ Choosing the AC wireless mode will populate the supported 5 GHz channels for you
![](https://i.imgur.com/ZAxB8Wf.png) ![](https://i.imgur.com/ZAxB8Wf.png)
**Longer answer:** AC support is not simply a function of the RPi 3B+/4's hardware capabilities. It must also take into account regulatory restrictions of the wireless spectrum. The regulatory info for brcmfmac, the kernel driver that supports the Broadcom wireless chipset, is embedded in the firmware. There are lots of [international issues with WiFi](https://en.wikipedia.org/wiki/List_of_WLAN_channels#5_GHz_or_5.8_GHz_(802.11a/h/j/n/ac/ax)) that restrict channel use, transmission power, etc. on a regional and per-country basis. As a result, only combinations of certain frequencies (channels) and countries are capable of hosting an AC access point with the RPi's wireless adapter. **Longer answer:** AC support is not simply a function of your device's hardware capabilities. It must also take into account regulatory restrictions of the wireless spectrum. The regulatory info for `brcmfmac`, the kernel driver that supports the Broadcom wireless chipset, is embedded in the firmware of RPi models 3B+ and 4. There are lots of [international issues with WiFi](https://en.wikipedia.org/wiki/List_of_WLAN_channels#5_GHz_or_5.8_GHz_(802.11a/h/j/n/ac/ax)) that restrict channel use, transmission power, etc. on a regional and per-country basis. As a result, only combinations of certain frequencies (channels) and countries are capable of hosting an AC access point with the RPi's wireless adapter.
If the country configured on your RPi does not allow use of a particular segment of the 5 GHz wireless spectrum, an AC configured AP will fail to start. Errors like these are common: If the country configured on your RPi does not allow use of a particular segment of the 5 GHz wireless spectrum, an AC configured AP will fail to start. Errors like these are common:
@ -262,7 +261,7 @@ hostapd: Could not set channel for kernel driver
In testing, stable AP's on the RPi's supported AC channels were only reliably obtained with 'US' as the regulatory domain. To get a list of the supported channels on your RPi for the 2.4 and 5 GHz bands, use `iw phy phy0 channels`. Refer to [this issue](https://github.com/billz/raspap-webgui/issues/450#issuecomment-569343686). In testing, stable AP's on the RPi's supported AC channels were only reliably obtained with 'US' as the regulatory domain. To get a list of the supported channels on your RPi for the 2.4 and 5 GHz bands, use `iw phy phy0 channels`. Refer to [this issue](https://github.com/billz/raspap-webgui/issues/450#issuecomment-569343686).
## <a name="wificountries"></a>I think my country allows 5 GHz AP channels. Can I test this? ## <a name="wificountries"></a>I think my country allows 5 GHz AP channels. Can I test this?
Yes, you can. In the spirit of experimentation and discovery, this project makes it easy to override RaspAP's [default configuration](https://github.com/billz/raspap-webgui/wiki/Reporting-issues#default-settings). The file [wireless.json](https://github.com/billz/raspap-webgui/blob/master/config/wireless.json) contains the regulatory domains and channels for the 2.4 and 5 GHz bands. Add a valid ISO Alpha-2 country code to the list of `5Ghz_max48ch` countries and save the file. Next, edit `includes/config.php` and add the same country to this constant: Yes, you can. In the spirit of experimentation, this project allows you to override RaspAP's [default configuration](https://github.com/billz/raspap-webgui/wiki/Reporting-issues#default-settings). The file [wireless.json](https://github.com/billz/raspap-webgui/blob/master/config/wireless.json) contains the regulatory domains and channels for the 2.4 and 5 GHz bands. Add a valid ISO Alpha-2 country code to the list of `5Ghz_max48ch` countries and save the file. Next, edit `includes/config.php` and add the same country to this constant:
``` ```
// Constant for the 5GHz wireless regulatory domain // Constant for the 5GHz wireless regulatory domain