K3sClusterOptions
Classsealednet10.0
Advanced options for
K3sBuilderExtensions.AddK3sCluster . namespace CommunityToolkit.Aspire.Hosting;
public sealed class K3sClusterOptions{ // ...}13 members
Remarks
Section titled RemarksMost settings are exposed directly as fluent builder methods — prefer those for discoverability and TypeScript polyglot compatibility:
K3s— number of worker nodesBuilder Extensions. With Agent Count K3s— k3s image tagBuilder Extensions. With K3s Version K3s— pod CIDR (Builder Extensions. With Pod Subnet -)- cluster- cidr K3s— service CIDR (Builder Extensions. With Service Subnet -)- service- cidr K3s— disable built-in componentsBuilder Extensions. With Disabled Component K3s— raw k3s server argumentsBuilder Extensions. With Extra Arg K3s— Helm installer imageBuilder Extensions. With Helm Image K3s— kubectl imageBuilder Extensions. With Kubectl Image K3s— persistent data volumeBuilder Extensions. With Data Volume K3s— container lifetimeBuilder Extensions. With Lifetime
Constructors1
Section titled ConstructorsProperties12
Section titled PropertiesAgentCount get; setint Gets or sets the number of agent (worker) nodes. Defaults to
0 (single-node cluster). ClusterCidr get; setstring? Gets or sets the pod IP address range in CIDR notation (
--cluster-cidr ). Defaults to k3s built-in value of 10.42.0.0/16 when null. IList<string> Gets the list of built-in k3s components to disable (each passed as
--disable=<component> ). ExtraArgs getIList<string> Gets the list of raw arguments appended verbatim to the
k3s server command. HelmRegistry get; setstringGets or sets the container registry for the Helm installer image. Defaults to
docker.io .ImageTag get; setstring? Gets or sets the k3s container image tag, e.g.
v1.32.3-k3s1 . When null the version bundled with this package is used. KubectlRegistry get; setstringGets or sets the container registry for the kubectl image. Defaults to
docker.io .ServiceCidr get; setstring? Gets or sets the Service cluster IP address range in CIDR notation (
--service-cidr ). Defaults to k3s built-in value of 10.43.0.0/16 when null. 
Aspire