# K3sClusterResource.WithK3sVersion

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

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
type K3sClusterResource interface {
    // ... omitted for brevity
    WithK3sVersion(tag string) K3sClusterResource
}
```

## Signature

```go
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()`.

## Defined on

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