Skip to main content
← back to extensions

Tailscale

@bitgnome/tailscalev2026.06.21.1· 15d agoMODELSWORKFLOWS
01README

Tailscale for swamp: a setup-tailscale workflow that installs Tailscale and joins hosts of an @swamp/ssh fleet to the tailnet (auth key via vault + SSH env), plus a net model that syncs tailscale status --json into one resource per machine so downstream models and workflows can look up nodes by name.

02Models1
tailscale_net.tsv2026.06.19.1
fn sync()
Parse tailscale status JSON and write a named resource per machine
03Workflows1
@bitgnome/setup-tailscale61ec1f61-dc9d-4d02-a84d-84ed22bab548

Install Tailscale on hosts of an existing @swamp/ssh fleet and join them to the tailnet using an auth key resolved from a vault. Idempotent — once joined, tailscaled reconnects on every boot; re-run after rebuilding a host. The auth key is read via vault.get and forwarded over the SSH env (AcceptEnv TS_AUTHKEY) so it never lands in argv or swamp's persisted run data. Requires (in the consuming repo): - an @swamp/ssh model instance whose name you pass as `sshModel`, and - a vault named `tailscale-secrets` holding the key `TS_AUTHKEY`.

joinEnroll the fleet's hosts into the tailnet over SSH.
1.check-ssh— Verify SSH connectivity to the hosts before enrolling.
2.enable-acceptenv— Tell each host's sshd to AcceptEnv TS_AUTHKEY so the next step can forward the auth key via SSH env (keeps the secret out of argv and swamp logs).
3.tailscale-up— Install Tailscale (if needed) and bring each host up on the tailnet.
04Previous Versions1
2026.06.19.1Jun 19, 2026
05Stats
A
100 / 100
Downloads
1
Archive size
6.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/bitGnome/swamp-tailscale
06Platforms
07Labels
#tailscale#networking#vpn#inventory