Bring your own VPS · no server to buy · open source
vpncloud installs, hardens and runs VPN servers on a VPS you already have — over SSH, using playbooks you can read. Your traffic goes from your devices straight to your server, never through us.
$ ansible-playbook playbooks/wireguard/install.yml
PLAY [Install WireGuard on target VPS]
TASK [Assert the kernel provides WireGuard]ok
TASK [Harden SSH]changed
TASK [Configure the baseline firewall]changed
TASK [Configure fail2ban]changed
TASK [Enable unattended security updates]changed
TASK [Enable IPv4 forwarding (sysctl)]changed
TASK [Template WireGuard server config]changed
TASK [Enable and start wg-quick@wg0]changed
TASK [Health check — run 'wg show']ok
PLAY RECAP 203.0.113.10 : failed=0 unreachable=0
→ default.conf · Endpoint = 203.0.113.10:51820
01Bring your own VPS
Rent from any provider or use hardware you own. vpncloud connects over SSH, installs the VPN and steps back. Switch providers whenever you like — a migration can carry the server's keys, so existing clients keep working.
or anything else with root SSH
02Deployment
Add its address and SSH port. Trust our SSH certificate authority once, or use a key. The first probe pins the host key and detects the OS.
ssh [email protected] · host key pinnedA compatibility check runs before anything changes, and ports and subnets are checked against what is already installed.
wireguard · udp/51820 · 10.8.0.0/24The server is hardened first — SSH, a default-deny firewall, fail2ban, automatic security updates — then the VPN is installed and health-checked. Every line streams live.
sshd · ufw · fail2ban · wg-quick@wg0Scan the QR code or open the config in the official app for your device. Add people, caps and expiry dates later from the dashboard.
default.conf · QR03Architecture
vpncloud reaches your server over SSH while it installs and when you manage it. Once a device connects, the tunnel runs between that device and your VPS — there is no vpncloud relay to route through.
04Protocols
Each protocol is a module: a manifest, an Ansible role and its management tools. People connect with the protocol's own apps on iOS, Android, macOS, Windows and Linux — vpncloud is not a VPN client.
udp/51820Fastest default for most people
12 toolsQR import
udp/1194Widest compatibility, through strict firewalls
6 toolsQR import
udp/500,4500Built into iOS, macOS and Windows — no app to install
6 toolsProfile file
tcp/443Looks like ordinary TLS to a real website
7 toolsQR import
udp/51821WireGuard for networks that fingerprint WireGuard
8 toolsQR import
quic/443Fast on lossy mobile and hotel networks
6 toolsQR import
quic/443Low-latency UDP for calls and games
6 toolsQR import
tcp+udp/8388Lightweight proxy for small servers
6 toolsQR import
57 management tools across all protocols, by risk tier
Tier 0 runs at once. Anything higher shows you exactly what it will do and waits for your confirmation.
05Manage
Ask the assistant on each server to add a client, list who is connected or restart the service. It answers with the exact tool and arguments it will use, and changes nothing until you confirm.
Add a client for Lily's laptop
I'll create one WireGuard client on this server.
wireguard__create_clienttier 1name: "lily-laptop" # ^[a-zA-Z0-9_-]{1,32}$
06Security
ssh.certificate · ttl 30mShort-lived SSH certificates (30 minutes) in certificate mode. The host key is pinned, and a mismatch stops the job.
tools · no raw shell (ADR-0003)No raw shell. The assistant can only call named tools with bounded arguments.
configs · encrypted per userClient configs are encrypted per user before they are stored.
audit_log · prev_hashEvery change is written to an append-only, hash-chained audit log.
agent · report-only (ADR-0008)The optional agent on your server only reports. It cannot be told to do anything.
sshd · ufw/firewalld · fail2banEvery install hardens SSH and turns on a default-deny firewall, fail2ban and security updates.
07Editions
We run the control plane and the AI. You bring the VPS and sign in.
The open-source edition on your own machine with Docker Compose, under AGPL-3.0. Bring your own AI key.
$ cd infra/docker-compose$ docker compose \ -f docker-compose.prod.yml \ --env-file .env.prod up -d
| Feature | Cloud | Self-hosted |
|---|---|---|
| Installer engine and playbooks | Included | Included |
| All eight protocols | Included | Included |
| AI management | managed | your API key |
| Who runs the control plane | us | you |
| License | proprietary | AGPL-3.0 |
Neither edition sells you a server. Both run on the VPS you choose.
08Open source
Installs are Ansible playbooks in the repository, not a black box. Each protocol declares its tools, their risk tier and the exact shape of every argument, and CI validates the manifests and lints the playbooks.
- name: create_clienttier: 1description: Create a new WireGuard client, add its peer to wg0, and return the client config file.implementation: tools/create_client.ymlargs:name:type: stringpattern: "^[a-zA-Z0-9_-]{1,32}$"required: trueYour server, your keys, your traffic.