Skip to content

Releases

0.4.0

Choose a tag to compare

@moonmouse11 moonmouse11 released this 06 Nov 07:23
491c50a

Upgrade required

After updating, open the VPN panel and run Update setup, or run make install from your checkout. Updating the plugin clone alone does not replace installed root helpers and trusted modules.

Existing profiles, keys, subscriptions, favourites and recent connections are retained. Old protection-cache records become unverified until refreshed or retested.

Highlights

  • INCY Desktop subscriptions alongside Happ: server groups, refresh, headless connect/disconnect and xray-based ping. Validated with INCY Desktop 3.9.0 and bundled Ferrum 26.10.13; the app and plugin cannot own a tunnel simultaneously.
  • Profile management improvements: delete VLESS/Shadowsocks keys, manage OpenVPN autostart and disconnect orphan WireGuard/AmneziaWG interfaces.
  • Copy exit IP from the connection summary and faster cache-only status polling.

Security and reliability

  • Endpoint bootstrap uses authenticated, uplink-bound DNS sockets restricted to configured IPv4 upstreams. Ordinary application and shared systemd-resolved DNS receive no kill-switch exception.
  • WireGuard, AmneziaWG and OpenVPN share one endpoint snapshot between firewall rules and private numeric runtime profiles. No public DNS fallback or automatic DNS-settings rewrite is introduced; unsupported strict DoT/local-proxy configurations fail explicitly.
  • INCY native code runs as the desktop user; fixed root-owned brokers provide narrowly validated network operations.
  • WG/AWG SaveConfig preserves original hostnames, IPv6 interface addresses and peer AllowedIPs while retaining native changes. Recovery refuses to overwrite replacement credentials and retains private recovery data on conflict.
  • Protection checks and Happ/INCY actions distinguish subscriptions even when server names match.
  • Bootstrap permissions follow resolver changes during switching; failed setup remains fail-closed.
  • OpenVPN detects standard systemd units without helper PID files. Managed autostart units use the fixed PID/DNS lifecycle and optional IPv6 boot guard.
  • DNS probe cancellation no longer waits for stuck libc lookups. Uninstall cleans managed boot/service drop-ins before deleting its helper and aborts if cleanup fails.

Compatibility notes

  • OpenVPN option names must be plain: quoted or escaped option names are rejected; quoted hostname arguments remain supported.
  • Tunnels remain IPv4-only. The optional IPv6 guard disables IPv6 rather than tunnelling it.
  • NetworkManager VPNs remain outside the plugin-managed kill switch.
  • INCY configurations containing Shadowsocks temporarily disable TUN sniffing to avoid a reproduced external-TUN-FD HTTP/TLS stall. Domain rules requiring sniffed names may not match; IP-based rules and kill-switch separation are unchanged. VLESS-only configurations retain sniffing.

Full changes: CHANGELOG.md.

0.3.2

Choose a tag to compare

@moonmouse11 moonmouse11 released this 28 Oct 11:27
1721aeb

Root helpers are installed from a copy read before sudo; the sudoers rule names the numeric uid. Run Update setup after updating. Full notes in CHANGELOG.md.

0.3.1

Choose a tag to compare

@moonmouse11 moonmouse11 released this 27 Oct 12:45
6bcc7c6

Fixes the marketplace listing text and "1 server". Full notes in CHANGELOG.md.

v0.3.0

Choose a tag to compare

@moonmouse11 moonmouse11 released this 26 Oct 23:42
e653bfe

Release 0.3.0: marketplace install, a much narrower root surface, and fixes for hanging connects. Full notes in CHANGELOG.md.

Important

Privileged code changed (CONTRIBUTING: plugins.omarchy.org needs a new maintainer review):
install.sh (and the sudoers rule it writes), uninstall.sh, and the new
scripts/omarchy-vpn-helper. The sub-intercept-* / happd-sniff* / happd-extract-config.py
scripts are removed. happ-killswitch is unchanged since v0.2.0.

Highlights

  • Marketplace install: omarchy plugin add downloads the plugin, and the panel's Finish setup / Update setup runs install.sh in a terminal. An install wizard asks for protocols and features before any password and installs only the packages they need.
  • Security:
    • The sudoers rule is cut down to three fixed entry points. Before, it let any user process get passwordless root (wg-quick *, cp/cat wildcards, kill).
    • The root helper refuses imports that could run commands as root. For WireGuard that means PostUp and its kin. For OpenVPN, a config is imported only if every directive is on an allowlist. WireGuard profile names longer than 15 characters are refused too.
    • IPv6 no longer leaks at boot or while switching servers.
    • The subscription header capture, which used a local CA, is removed.
  • Fixed:
    • Happ connects no longer hang on a stale subscription.
    • Quick clicks while switching no longer answer "Already switching".
    • A connect is refused while the Happ app holds the tunnel.
    • A failed setup step says "Setup failed" instead of "Done!".
    • Background subscription failures are logged.
  • README is rewritten for users, with badges. Real provider names and identifiers are removed from code and tests.

Upgrading

After omarchy plugin update omarchy-vpn, press Update setup in the panel (or run make install from a checkout). The sudoers rule, helpers and backend are copies and only change then.

Tested

  • make test-docker: 839 passed; ruff, mypy, shellcheck (--severity=warning) clean; SonarCloud quality gate passed with 0 open issues.
  • Fresh Omarchy 4.0.6 VM, on dev:
    • omarchy plugin validate and plugin add;
    • Finish setup through the wizard and sudo;
    • the panel, the window and SUPER+Shift+V;
    • plugin update, then Update setup;
    • uninstall.sh and plugin remove.
  • After setup, the sudoers rule allowed only the three entry points. After uninstall, nothing was left behind except ~/.config/vpn-manager.

[0.2.0]

Choose a tag to compare

@moonmouse11 moonmouse11 released this 17 Oct 23:27
0728a97

What's Changed

New Contributors

Full Changelog: https://github.com/moonmouse11/omarchy-vpn/commits/v0.2.0