Docs

Browse releases →

k3s-worker

AOS exposed Lightweight Kubernetes (agent / worker) package

k3s-worker

AOS exposed Lightweight Kubernetes (agent / worker) 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-worker"];
  k3s.enable = true;
  k3s.token.ref = "system-credential:k3s-token";
}
OptionTypeDescription
enablebooleanEnable the selected k3s role.
integrations3 children
kubeconfigModeone of ["0600","0640","0644"]Mode of the administrator kubeconfig emitted by server roles.
networking7 children
node5 children
roleone of ["worker","control-plane","combined"]The k3s role implemented by the selected package.
server3 children
serverUrlstring matching .+ or nullHTTPS URL of an existing k3s server to join.
tokensubmodule or nullOpaque reference to the cluster token loaded as a systemd credential.