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";
}

k3s.networking

OptionTypeDescription
clusterCidrstring matching .+ or nullCIDR from which pod addresses are allocated.
clusterDnsstring matching .+ or nullCluster DNS service address.
disableKubeProxybooleanDisable kube-proxy for a replacement data plane.
disableNetworkPolicybooleanDisable the built-in network-policy controller.
flannelBackendone of ["vxlan","host-gw","wireguard-native","none"]Flannel backend, or `none` when an external CNI owns pod networking.
flannelInterfacestring matching .+ or nullHost interface used for Flannel traffic.
serviceCidrstring matching .+ or nullCIDR from which service addresses are allocated.