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

Updated with OpenVPN

Bill Zimmerman 2019-11-18 13:42:37 +01:00
parent 1414baec05
commit efbe825308

20
FAQs.md

@ -15,6 +15,7 @@ This has been written to address some frequently asked questions among users of
* [WiFi scanning doesn't work. Help!](#scanning)
* [Can the Quick Installer accept the default options without prompting me?](#unattended)
* [Can I configure an alternate port for RaspAP's web service?](#webport)
* [OpenVPN fails to start and/or I have no internet. Help!](#openvpn)
### <a name="settings"></a>What do all these settings in the UI do? Changing them seems to have no effect.
RaspAP manipulates several daemons, services and helper programs behind the scenes for you. In the footer of each management panel is a helpful "Information provided by..." label. These indicate which Linux daemon and/or program is being modified by the UI. Learning what these services are and how they work will go a long way toward demystifying things.
@ -222,7 +223,9 @@ wget -q https://git.io/voEUQ -O /tmp/raspap && bash /tmp/raspap --yes
The options `-y` or `--assume-yes` are also accepted and have the same result.
### <a name="webport"></a>Can I configure an alternate port for RaspAP's web service?
Yes, changing lighttpd's default port is trivial. Edit `/etc/lighttpd/lighttpd.conf` and change the following line:
Yes, you can now do this from the *Advanced* tab in System. Manual steps for changing lighttpd's default port are included below.
Edit `/etc/lighttpd/lighttpd.conf` and change the following line:
```
server.port = 8080
@ -231,4 +234,17 @@ then give the service a kick...
```
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="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):
```
-A FORWARD -i tun0 -o wlan0 -m state --state RELATED,ESTABLISHED -j ACCEPT
-A FORWARD -i wlan0 -o tun0 -j ACCEPT
```
It is your responsibility to provide a valid .ovpn file—RaspAP does not attempt to validate the settings or RSA keys contained in this file. If OpenVPN fails to start, check for errors with `sudo systemctl status openvpn-client@client` and `journalctl --identifier openvpn`.