Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/angristan/wireguard-install
WireGuard VPN installer for Linux servers
https://github.com/angristan/wireguard-install
linux nat privacy vpn wireguard
Last synced: 2 days ago
JSON representation
WireGuard VPN installer for Linux servers
- Host: GitHub
- URL: https://github.com/angristan/wireguard-install
- Owner: angristan
- License: mit
- Created: 2019-05-05T10:43:50.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-07T20:01:35.000Z (about 1 month ago)
- Last Synced: 2024-12-03T02:00:08.861Z (9 days ago)
- Topics: linux, nat, privacy, vpn, wireguard
- Language: Shell
- Homepage: https://stanislas.blog/2019/01/how-to-setup-vpn-server-wireguard-nat-ipv6/
- Size: 127 KB
- Stars: 8,470
- Watchers: 124
- Forks: 1,346
- Open Issues: 74
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-wireguard - angristan/WireGuard-install - WireGuard VPN installer for Linux servers. (Projects / User Interface)
- awesome-starred - wireguard-install - WireGuard VPN installer for Linux servers (Shell)
README
# WireGuard installer
[](https://saythanks.io/to/angristan)
**This project is a bash script that aims to setup a [WireGuard](https://www.wireguard.com/) VPN on a Linux server, as easily as possible!**
WireGuard is a point-to-point VPN that can be used in different ways. Here, we mean a VPN as in: the client will forward all its traffic through an encrypted tunnel to the server.
The server will apply NAT to the client's traffic so it will appear as if the client is browsing the web with the server's IP.
The script supports both IPv4 and IPv6. Please check the [issues](https://github.com/angristan/wireguard-install/issues) for ongoing development, bugs and planned features! You might also want to check the [discussions](https://github.com/angristan/wireguard-install/discussions) for help.
WireGuard does not fit your environment? Check out [openvpn-install](https://github.com/angristan/openvpn-install).
## Requirements
Supported distributions:
- AlmaLinux >= 8
- Arch Linux
- CentOS Stream >= 8
- Debian >= 10
- Fedora >= 32
- Oracle Linux
- Rocky Linux >= 8
- Ubuntu >= 18.04
## Usage
Download and execute the script. Answer the questions asked by the script and it will take care of the rest.
```bash
curl -O https://raw.githubusercontent.com/angristan/wireguard-install/master/wireguard-install.sh
chmod +x wireguard-install.sh
./wireguard-install.sh
```
It will install WireGuard (kernel module and tools) on the server, configure it, create a systemd service and a client configuration file.
Run the script again to add or remove clients!
## Providers
I recommend these cheap cloud providers for your VPN server:
- [Vultr](https://www.vultr.com/?ref=8948982-8H): Worldwide locations, IPv6 support, starting at \$5/month
- [Hetzner](https://hetzner.cloud/?ref=ywtlvZsjgeDq): Germany, Finland and USA. IPv6, 20 TB of traffic, starting at 4.5€/month
- [Digital Ocean](https://m.do.co/c/ed0ba143fe53): Worldwide locations, IPv6 support, starting at \$4/month
## Contributing
## Discuss changes
Please open an issue before submitting a PR if you want to discuss a change, especially if it's a big one.
### Code formatting
We use [shellcheck](https://github.com/koalaman/shellcheck) and [shfmt](https://github.com/mvdan/sh) to enforce bash styling guidelines and good practices. They are executed for each commit / PR with GitHub Actions, so you can check the configuration [here](https://github.com/angristan/wireguard-install/blob/master/.github/workflows/lint.yml).
## Say thanks
You can [say thanks](https://saythanks.io/to/angristan) if you want!
## Credits & Licence
This project is under the [MIT Licence](https://raw.githubusercontent.com/angristan/wireguard-install/master/LICENSE)
## Star History
[](https://star-history.com/#angristan/wireguard-install&Date)