Skip to content

The agent that grows with you

plugin-catalog: repin netplane 0.3.0 with approved Headscale setup

Jeffrey Watts230a40ea6f75
diff --git a/plugin-catalog/netplane.yaml b/plugin-catalog/netplane.yaml
index 0e7848a861d..6b6aba60558 100644
--- a/plugin-catalog/netplane.yaml
+++ b/plugin-catalog/netplane.yaml
@@ -1,32 +1,37 @@
name: netplane
repo: https://github.com/lEWFkRAD/netplane
-sha: cdda4d5e6d7484a79364af9e1a233b1333d26700
+sha: 10b6bff5cf5bb521d39e4443d9d33ee6768fbb23
description: >-
- Run and operate your own self-hosted Tailscale network (a Headscale control plane) from
- inside Hermes: netplane_status checks local service/serve wiring and gRPC node health,
- netplane_nodes lists tailnet devices with addresses, last-seen and online state, and
- netplane_preauth lists preauth-key metadata without stored join secrets or, after explicit
- approval, mints and returns a new single-use-by-default join secret with a 1–168 hour
- lifetime. Ships a Desktop pane with health status, node rows, preauth-key rows and a New
- join key action, plus a FastAPI backend under /api/plugins/netplane. Headscale v0.29.6
- protobuf stubs are bundled; scripts/gen_proto.sh pins its upstream sources and toolchain.
- Requires a reachable Headscale control plane with gRPC enabled and NETPLANE_APIKEY in the
- active Hermes profile's secret scope; the plugin installs no server and never reads
- credentials from process environment or disk. Disclosure — read-only against the control
- plane except explicit preauth-key creation and user-confirmed node expiration in Desktop;
- loopback gRPC may use plaintext while non-loopback targets use TLS with system trust.
- Status runs systemctl is-active headscale and tailscale serve status best-effort. Node
- names, hostnames and IPs stay between Hermes and the configured control plane; there is no
- telemetry or third-party service.
+ Install, configure and operate a self-hosted Headscale control plane from Hermes.
+ netplane_setup previews a configuration and, after approval, installs the pinned official
+ Headscale v0.29.6 DEB on a fresh Debian 12+ or Ubuntu 22.04+ systemd host (amd64/arm64).
+ Installation runs on the Hermes host, requires root or noninteractive sudo, refuses
+ existing deployments, and verifies the package SHA-256. It configures SQLite, MagicDNS,
+ embedded DERP/STUN, local admin gRPC, and either Let's Encrypt HTTPS or a loopback backend
+ for an existing reverse proxy. It starts the system service, creates the first user, and
+ saves a 90-day API key and connection settings through Hermes's active-profile APIs.
+ netplane_status reports health, netplane_nodes lists devices, and netplane_preauth lists
+ metadata without stored join secrets or creates an approval-gated, single-use-by-default
+ join key with a 1–168 hour lifetime. Desktop includes setup preview/confirmation, health,
+ nodes, join keys and confirmed node expiration, with a FastAPI backend. Management requires
+ NETPLANE_APIKEY; setup works before a key exists. Bundled protobuf stubs use pinned sources
+ and a compatible toolchain. Disclosure — explicit installation downloads from GitHub and
+ may contact configured APT repositories; Let's Encrypt receives the chosen domain/email.
+ Setup uses APT/dpkg, systemctl, runuser and Headscale commands, writes system configuration
+ and data, and enables a persistent service with the listeners shown in its preview.
+ Public DNS/firewall changes, proxy installation, upgrades and device migration are not
+ performed. Partial installs are preserved for repair. Management reads credentials only
+ from Hermes; off-host gRPC uses TLS with system trust. Status also runs systemctl is-active
+ headscale and tailscale serve status. No telemetry or automatic software updates.
maintainer: lEWFkRAD
tier: community
category: tools
-requires_hermes: ">=0.19"
+requires_hermes: ">=0.21.6"
docs_url: https://github.com/lEWFkRAD/netplane#readme
-version: "0.2.0"
+version: "0.3.0"
platforms: []
capabilities:
- provides_tools: [netplane_status, netplane_nodes, netplane_preauth]
+ provides_tools: [netplane_setup, netplane_status, netplane_nodes, netplane_preauth]
provides_hooks: [pre_tool_call]
provides_middleware: []
- requires_env: [NETPLANE_APIKEY]
+ requires_env: []