Set Up an Outline VPN Server — The VPN Built for Sharing, on Your Own VPS
Watch on YouTube ↗ — if the player asks you to sign in, YouTube is flagging your network; the video itself is public and plays on YouTube directly.
On this page
Last episode we built a WireGuard VPN by hand, with config files and QR codes. This time we do it the friendly way. Outline — a VPN server from the Outline Foundation, originally created at Google's Jigsaw — is designed from day one to be shared with other people: one install command on the server, one desktop app to manage it, and a clean client app for everyone you invite. No config files to edit, ever.
In this guide we install the Outline server on the same VPS that already runs our wg-easy stack, connect the Outline Manager, create a named access key, connect a laptop with the Outline Client, and verify the tunnel with real traffic. Everything below was tested end to end on 2026-11-21.
What you need
- A Linux server with Docker installed (we use the same server as the earlier episodes in this series)
- A subdomain pointing at the server — ours is
outline.deploysaga.com - Two ports reachable on the server: 8081/TCP (management) and 8388, TCP and UDP (access keys)
If you need a server, we run this series on an InterServer VPS — the first slice is about $3/month and is plenty for a small team's VPN. Any other VPS works exactly the same way; Outline itself is free and open source.
Step 1 — Install the server
There is no package to hunt down. The official installer script does everything: it checks Docker, pulls two containers — Shadowbox (the server) and Watchtower (which keeps it updated) — generates a self-signed TLS certificate, creates the first access key, and starts everything.
wget -qO install_server.sh https://raw.githubusercontent.com/OutlineFoundation/outline-apps/master/server_manager/install_scripts/install_server.sh
sudo bash install_server.sh --hostname outline.deploysaga.com --keys-port 8388 --api-port 8081The two flags pin the ports so your firewall rules stay predictable:
--hostname— the public name your clients will dial (use your subdomain, or the server's public IP)--keys-port 8388— where access-key traffic arrives, TCP and UDP--api-port 8081— the management API the Outline Manager talks to
About 35 seconds later the installer prints CONGRATULATIONS! Your Outline server is up and running, followed by the one line that matters — a green JSON blob:
{"apiUrl":"https://outline.deploysaga.com:8081/<your-server-id>","certSha256":"<64-hex-character-fingerprint>"}Copy the whole line, brackets and all, and treat it like a password. It is the management key to this server: anyone who holds it can create and revoke access keys. You will paste it into the Manager in the next step.
Step 2 — Connect the Outline Manager
On your own computer, download the Outline Manager from getoutline.org (Windows, macOS and Linux builds are on the same page), install it, and open it.
- On the "Choose a cloud service" screen, choose Set up Outline anywhere (bottom right).
- Step 1 shows the same install command you just ran — skip it, you have already done it.
- In Step 2, paste the JSON line from the installer output and click Done.
The server appears with its hostname and its access keys — the installer already created a first one, Key 0. A small popup may note "You are not connected yet!" — that only means no client has connected so far; dismiss it.
Step 3 — Create an access key
This is where Outline earns its keep.
- Click Add new key. A fresh key appears instantly — no wizard, no form.
- Rename it from the three-dot (⋮) menu on its row — one key per person or per device, like
sarahs-phoneorteam-laptop. Ours is calledmy-laptop. - The same menu offers a data limit per key, and you can revoke a key the moment someone loses a device — nobody else's access changes.
- Click the share icon on the key's row, then Copy access key. You get a single
ss://link.
That link is the key and the password in one. Send it privately, never post it in public.
Step 4 — Connect the client
On the device that will use the VPN, install the Outline Client — again from getoutline.org (Windows, macOS, Linux, Android, iOS and ChromeOS).
- Open it and tap through the short privacy note (Got it).
- The Add VPN access key dialog appears automatically — paste the
ss://link and click Confirm. - The server shows up as a card: Outline Server — outline.deploysaga.com:8388. Click Connect.
- A tip card explains that Outline reconnects automatically after a restart — tap Got it.
That is it: connected. No config files, no QR codes, no port numbers to type. The first connection also installs a small network service on Windows — that is the client's tunnel driver, and it is expected.
Step 5 — Verify
Two checks, both worth doing:
- In the client: the card says Connected, and a web page loads through the tunnel.
- In the Manager: the
my-laptopkey now shows a Last active timestamp and a Usage counter — every byte through this server is counted per key, so you can see this exact device is really going through your server.
On a public VPS there is a third check worth doing: open an IP-checker site in the browser — the address shown should be your server's, not your home connection's.
Gotchas we hit, so you don't have to
- Manager says "Server unreachable" → it keeps that error on screen even after the network recovers. Fully quit the Manager and reopen it; a fresh launch re-checks and connects.
- The client shows Connected but nothing loads → check the access-key port first: 8388 must be open for both TCP and UDP (cloud firewall / security group). TCP alone is not enough.
- Lost the green JSON line → it is shown once by the installer. Re-running the installer on the same machine prints the management details for the existing server; guard the line like a password either way.
- The certificate fingerprint must match exactly. The Manager pins the server's self-signed certificate using the
certSha256from the JSON line — copy the line whole, never retype the fingerprint by hand. - Key 0 is fine to keep — it is just the installer's first key. Rename it or delete it; your named keys are the ones to share.
Outline vs wg-easy — which one for you?
Both are free, open source and self-hosted on the same kind of VPS. The difference is who operates them day to day:
- wg-easy (last episode) is a web panel for your own devices — WireGuard protocol, config files and QR codes, everything under your hands.
- Outline is built for sharing: named keys per person, per-key usage and limits, one-link invites, and client apps a non-technical family member can actually use.
In the next episode we put both of them head to head with a commercial service like NordVPN — honest trade-offs, and which one you should actually pick.
