Docs

Browse releases →

k3s-control-plane

AOS exposed Lightweight Kubernetes (control plane, no agent) package

k3s-control-plane

AOS exposed Lightweight Kubernetes (control plane, no agent) package

1.35.1-k3s1 · aarch64-linux

CNI, CSI, and resources

Signed integration packages may contribute only the CNI, CSI, and Kubernetes resource subtrees. They cannot enable k3s or change node and cluster credentials.

Roles and bootstrap

Select exactly one of k3s-worker, k3s-control-plane, or k3s-combined. Workers require serverUrl; every enabled role receives its cluster token through an opaque systemd credential.

{
  aos.apm.desiredPackages = ["k3s-control-plane"];
  k3s.enable = true;
  k3s.token.ref = "system-credential:k3s-token";
}
OptionTypeDescription
clusterInitbooleanInitialize a new embedded-etcd cluster.
disableComponentslist of one of ["coredns","servicelb","traefik","local-storage","metrics-server","runtimes"]Packaged server components not deployed by k3s.
tlsSanslist of string matching .+Additional subject alternative names for the API server certificate.