Skip to content

K3s

K3s logo

K3s is the selected Kubernetes distribution used in the cluster. It provides a fully compliant Kubernetes distribution great for edge, embedded, and homelabs.

Installation

Control Plane (Server)

CNI Replacement with Cilium (Optional)

flannel-backend: "none"
disable-kube-proxy: true
disable-network-policy: true
disable:
  - traefik
  - servicelb
cluster-init: true

Installing With Script

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="server" sh -s - --config=$HOME/k3sconfig.yaml

Worker Node (Agent)

Obtain the server token with the following:

sudo cat /var/lib/rancher/k3s/server/token

Worker Node YAML

token: <your-k3s-token>
server: https://<your-ip>:<your-port>

Installing With Script

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="agent" sh -s - --config=$HOME/k3sagent.yaml

Alternatives

Other fantastic distributions:

Talos Linux

Talos Linux is an excellent choice for an operating system dedicated to Kubernetes providing a secure, immutable, and minimal design.