Skip to content
CoolerwavePublic

About

Your own WireGuard VPN in one command. Single or Double VPN, free and open source.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

coolervpn

Your own WireGuard VPN on an Ubuntu server, in one command. Free and open source.

Without a VPN your internet provider sees the name of every site you open. With coolervpn it sees one encrypted connection to your server and nothing else.

curl -O https://raw.githubusercontent.com/coolerwave/coolervpn/main/coolervpn.sh
sudo bash coolervpn.sh

Press Enter on every question if you're not sure. At the end you get a QR code: scan it with the WireGuard app on your phone and switch it on.

What it sets up

  • WireGuard, the VPN built into the Linux kernel.
  • A firewall that only lets the VPN through, and works on cloud images that block it by default (Oracle).
  • A choice of DNS: Google, Cloudflare, Quad9, or a private resolver on your own server.
  • IPv6 routed into the tunnel, so it can't leak around it.
  • Automatic security updates for the server.

Keys are generated on your server and never leave it, except in the configs for your own devices. Nothing is sent anywhere else, and only Ubuntu's official packages are installed.

Single or Double VPN

The script asks which one you want.

Single VPN: phone → server → internet. One server, enough for most people.

Double VPN: phone → entry server → exit server → internet. Put the servers in two different countries. The entry server knows who you are but only sees an encrypted stream. The exit server sees the sites but doesn't know who you are. If the exit server goes down, traffic stops instead of going straight out of the entry server.

To set it up:

  1. On the exit server run the script and choose 2. It prints a long key.
  2. On the entry server run the script, choose 3 and paste that key.
  3. Scan the QR code from the entry server.

After installing

Run sudo bash coolervpn.sh again for a menu: add a device, remove one, show a QR code again, or uninstall.

Or directly:

sudo bash coolervpn.sh --add laptop
sudo bash coolervpn.sh --remove laptop
sudo bash coolervpn.sh --list
sudo bash coolervpn.sh --uninstall

Requirements

  • Ubuntu 22.04 or 24.04 on a VPS (Hetzner, DigitalOcean, Vultr, Oracle Cloud and so on). Any small plan works.
  • UDP port 51820 open in your provider's firewall, if it has one turned on. The script tells you where to find it.
  • A clean server. If WireGuard is already set up (for example with Nyr's wireguard-install), the script stops instead of overwriting it.

What a VPN does and doesn't do

Your provider stops seeing which sites you open. Your hosting company can see traffic leaving the server, the same way your provider used to. A VPN doesn't protect you from viruses or phishing, and it doesn't hide who you are once you log in to an account.

Also in this repo

isp-sees: a dashboard that shows, live, which sites your provider can see you open. Run it before and after turning the VPN on.

Credits

Built with Claude Code. Inspired by Nyr/wireguard-install, written from scratch.

MIT License.

About

Your own WireGuard VPN in one command. Single or Double VPN, free and open source.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages