Pi-hole/pivpn
Pi-hole/pivpn
1
0
Fork 0
mirror of https://github.com/pivpn/pivpn.git synced 2024-10-18 05:33:32 +00:00
Code Issues Projects Releases Packages Wiki Activity

Updated Home (markdown)

Orazio 2020-02-01 11:49:59 +01:00
parent f7c93a2d24
commit 2741bfe6ff
1 changed files with 15 additions and 47 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

62
Home.md

@ -1,59 +1,29 @@
# PiVPN Wiki
## What boards/OSes does PiVPN support?
PiVPN runs at least on the following boards:
* Raspberry Pi 1/2/3/4 running Raspbian Stretch, Raspbian Buster Lite.
* All SBC's running DietPi. This is currently: Odroid C1, Odroid C2 (arm64), Odroid XU3/4, Pine A64, NanoPi NEO, NanoPi NEO Air, NanoPi M1, Nan>
* Most servers running a Debian or Ubuntu based distro.
### What About Octopi?
https://github.com/guysoft/OctoPi/issues/373 OctoPi doesn't play well with PiVPN installer as they use a git wrapper that blocks it from running as root user. To disable the git wrapper please do: `sudo rm /root/bin/git`
## Testing
Can install from test branch via
`curl -L https://raw.githubusercontent.com/pivpn/pivpn/test/auto_install/install.sh | TESTING= bash`
`curl -L https://test.pivpn.dev | TESTING= bash`
## Latest changes into master branch?
to know what has changed in the master branch read: https://github.com/pivpn/pivpn/blob/master/LatestUpdate.md
To know what has changed in the master branch read: https://github.com/pivpn/pivpn/blob/master/LatestUpdate.md
## Updating OpenVPN to newer version
## My ISP doesn't give me a static external IP address, so my servers IP address keeps changing!
If you installed an earlier version of pivpn and wish to update OpenVPN to a newer version (> 2.4.3) just do the following steps:
```
sudo -s
wget -O - https://swupdate.openvpn.net/repos/repo-public.gpg | apt-key add -
echo "deb http://build.openvpn.net/debian/openvpn/stable [osrelease] main" > /etc/apt/sources.list.d/openvpn-aptrepo.list
```
where [osrelease] should be replaced with:
- **wheezy** (Debian 7.x)
- **jessie** (Debian 8.x)
- **precise** (Ubuntu 12.04)
- **trusty** (Ubuntu 14.04)
- **xenial** (Ubuntu 16.04)
More information can be found here: <https://community.openvpn.net/openvpn/wiki/OpenvpnSoftwareRepos>
## Setting up static IP for clients
1. Add this line `client-config-dir /etc/openvpn/ccd` in
`/etc/openvpn/server.conf`
2. Create client config directory
`sudo mkdir /etc/openvpn/ccd`
3. Fix permissions
`sudo chown -R pi:nogroup /etc/openvpn/ccd`
(Make sure to enter correct username, in this case it was pi)
4. Adding clients.
`sudo nano /etc/openvpn/ccd/exampleuser`
(Add clients with their common name, in this case `exampleuser.ovpn`)
5. Configuring static IP.
Add this line `ifconfig-push 10.8.0.3 255.255.255.0` to `/etc/openvpn/ccd/exampleuser`
6. Restart openvpn
`sudo service openvpn restart`
(Here 10.8.0.3 is going to be static IP for user `exampleuser`, if you want to configure additional users, repeat from step 4)
**Note: You have to assign static IP for all clients in order to avoid IP address conflict**
You will need a dynamic DNS service and a hostname. If your IP address changes, your hostname will then automatically point to the new IP address. Some free dynamic DNS services are <http://noip.com>, <http://freedns.afraid.org/> or <https://www.duckdns.org/>.
## DynDns
@ -110,6 +80,4 @@ Here is a decent [video tutorial](https://www.youtube.com/watch?v=pUBMcsvJfe4).
## Further Help
Trouble connecting over mobile data? Try [this](https://github.com/pivpn/pivpn/issues/54)
Check any closed issues with the [information](https://github.com/pivpn/pivpn/issues?q=is%3Aissue+is%3Aclosed+label%3Ainformation) label!