What problem does it solve?
Adds and configures remote machines as k3s nodes without requiring direct LAN access or opening Kubernetes ports, removing the need for manual on-node execution or complex firewall rules by routing cluster traffic over Tailscale's DERP relay.
Core Features & Use Cases
- Remote provisioning: SSH into a target, install Tailscale, authenticate, detect architecture, and install k3s agent or server as needed.
- Join or bootstrap clusters: Join an existing control plane using its Tailscale IP and k3s node-token, or bootstrap a new control plane and deploy the standard infrastructure stack.
- Idempotent and resilient: Detects existing installations, supports password-based SSH via sshpass, updates Alfred's config.yaml, and verifies node readiness with kubectl.
- Use case: Easily add a home or staging machine behind NAT to your fleet without exposing port 6443 by leveraging Tailscale and SSH.
Quick Start
Run the add-node command with the SSH target and optional cluster name, for example: /add-node [email protected] homelab