For the starter path we install k3s — a single-binary Kubernetes
distribution that runs comfortably on a 1–2 vCPU VM.
Install k3s
On the Linux host:
1 | curl -sfL https://get.k3s.io | sh - |
That installs k3s as a systemd unit, generates a kubeconfig at/etc/rancher/k3s/k3s.yaml, and starts a single-node control plane +
worker.
Verify the node is Ready
1 | sudo k3s kubectl get nodes |
Expected output:
1 | NAME STATUS ROLES AGE VERSION |
Already have a cluster?
You can skip k3s and use any cluster where you have cluster-admin.
Just point KUBECONFIG at it before continuing. See the
distribution notes
for tweaks needed on managed Kubernetes (EKS pod security, GKE node
images, etc.).
Required cluster capabilities
The Publisher needs:
privileged: true(sysctl tuning, iptables, tun device).NET_ADMIN+NET_RAWcapabilities.- Access to
/dev/net/tunfrom the host (or via the chart’stunDevice.hostPathmount innetworking.mode: pod). - Outbound HTTPS reachability to
*.goskope.com.
On k3s this works out of the box. On hardened clusters with PSArestricted, see pod-vs-host network.