townos-tunneld 0.0.3

Privileged helper that brings Town OS WireGuard overlays up
townos-tunneld-0.0.3 is not a library.

townos-tunneld

The privileged helper for Town OS tunnels.

A daemon, not a library, and not much use on its own — install it alongside townos-desktop, which is what talks to it.

Creating a WireGuard interface, setting its key, and adding its addresses and routes need CAP_NET_ADMIN. A desktop application that also parses network responses and draws a window must not hold that, so the capability lives here instead: a few hundred lines with no window, no network client, and one job. It listens on /run/town-os/tunneld.sock and answers three requests.

It takes no path from the client and opens no file the client names. The config arrives as text on the socket, so root never opens a path the caller can write.

Linux only. DNS for a tunnel is handed to systemd-resolved.

See CHANGELOG.md for what changed.

Licence

AGPL-3.0-only. See LICENSE.