# WithK3sVersion

- Module: [CommunityToolkit.Aspire.Hosting.K3s](/reference/api/go/communitytoolkit.aspire.hosting.k3s.md)
- Version: `13.6.1`
- Kind: `method`
- Defined on: [`K3sClusterResource`](/reference/api/go/communitytoolkit.aspire.hosting.k3s/k3sclusterresource.md)
- Source: [GitHub](https://github.com/CommunityToolkit/Aspire/tree/d9c2addac6f527ef2e33712d290b84574b455a3b)

Sets the k3s image version used by the cluster server and all its agent nodes.

## Remarks

All agent nodes are immediately synced to the same tag to prevent version skew
beyond the Kubernetes-supported ±1 minor version limit. The image tag is part of
the DCP container identity, so synchronisation must happen at configuration time.

## Definition

```go
func (K3sClusterResource) WithK3sVersion(tag string) K3sClusterResource
```

## Parameters

- `tag` (`string`) -- The k3s container image tag, e.g. `v1.32.3-k3s1`. Must follow the `v{major}.{minor}.{patch}-k3s{n}` format.

## Returns

[`K3sClusterResource`](/reference/api/go/communitytoolkit.aspire.hosting.k3s/k3sclusterresource.md) -- The same builder, for chaining.

Returns a handle; failures surface later via `Err()`.

## Applies to

- [`K3sClusterResource`](/reference/api/go/communitytoolkit.aspire.hosting.k3s/k3sclusterresource.md)
