Skip to content

ADR 0011 Road VPN

Zlatko Lakisic edited this page Aug 7, 2026 · 1 revision

ADR 0011 — Road VPN phone-home (OpenVPN + L2TP)

Status: Accepted
Date: 2026-08-07
Companions: Admin /admin/api/road, Admin Console


Context

On the road the Pi must reach Ada (and HA) through a VPN without committing secrets to git. Operators want OpenVPN and L2TP/IPsec from the admin console.


Decision

  1. At home = any local IPv4 in configured CIDRs (default 192.168.89/24, 192.168.90/24, 172.16.90/24). No SSID matching.
  2. Control plane = NetworkManager connection names via nmcli (optional sudo -n).
  3. Protocols: openvpn | l2tp | auto. Secrets stay in NM / local state.
  4. Off-home: monitor tunnel, probe health URL, heal with backoff. At home: bring VPN down.

Admin tab shows gray At home when VPN is idle by design (not red “down”).

Full text: docs/adr/0011-road-vpn.md in the main repo.


Related

Clone this wiki locally