From c42d49d60002a5977ff7916a27cd58656349d994 Mon Sep 17 00:00:00 2001 From: blkgrlcto Date: Mon, 6 Apr 2026 17:35:48 -0400 Subject: [PATCH 1/3] update eks docs to include config for the cluster token --- src/content/docs/aws/services/eks.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/src/content/docs/aws/services/eks.mdx b/src/content/docs/aws/services/eks.mdx index 987e002f..468c0b06 100644 --- a/src/content/docs/aws/services/eks.mdx +++ b/src/content/docs/aws/services/eks.mdx @@ -686,6 +686,17 @@ The default version is `1.35`. Users can specify the desired version when creating an EKS cluster in LocalStack using the `EKS_K3S_IMAGE_TAG` configuration variable when starting LocalStack. +## Configuring the k3d Cluster Token + +When LocalStack creates a k3d-backed EKS cluster, it starts the k3s server with an explicit cluster token. This token is used to authenticate agent nodes joining the cluster, ensuring consistent behavior across k3d versions and enabling dynamic node registration (for example, when using Karpenter). +By default, LocalStack uses localstack-k3d-cluster-token as the cluster token. You can override this value using the `EKS_K3D_CLUSTER_TOKEN` configuration variable: + +```bash +EKS_K3D_CLUSTER_TOKEN=my-custom-token localstack start +``` + +Any agent nodes added to the cluster — whether via k3d node create or k3s agent — will use the same token to authenticate with the k3s server. + ## Resource Browser The LocalStack Web Application provides a Resource Browser for managing EKS clusters. From a7dcca1c80a04cefe8d95a4401f8b3acf86e6eaf Mon Sep 17 00:00:00 2001 From: Quetzalli Date: Thu, 9 Apr 2026 16:03:21 +0200 Subject: [PATCH 2/3] Update src/content/docs/aws/services/eks.mdx Co-authored-by: Nikos --- src/content/docs/aws/services/eks.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/aws/services/eks.mdx b/src/content/docs/aws/services/eks.mdx index 468c0b06..d9befafd 100644 --- a/src/content/docs/aws/services/eks.mdx +++ b/src/content/docs/aws/services/eks.mdx @@ -688,7 +688,7 @@ Users can specify the desired version when creating an EKS cluster in LocalStack ## Configuring the k3d Cluster Token -When LocalStack creates a k3d-backed EKS cluster, it starts the k3s server with an explicit cluster token. This token is used to authenticate agent nodes joining the cluster, ensuring consistent behavior across k3d versions and enabling dynamic node registration (for example, when using Karpenter). +When LocalStack creates a k3d-backed EKS cluster, it starts the k3s server with an explicit cluster token. This token is used to authenticate agent nodes joining the cluster, enabling dynamic node registration. By default, LocalStack uses localstack-k3d-cluster-token as the cluster token. You can override this value using the `EKS_K3D_CLUSTER_TOKEN` configuration variable: ```bash From a34b5b0fb1939405faba8fc699e66a60699a849c Mon Sep 17 00:00:00 2001 From: Quetzalli Date: Thu, 9 Apr 2026 16:03:33 +0200 Subject: [PATCH 3/3] Update src/content/docs/aws/services/eks.mdx Co-authored-by: Nikos --- src/content/docs/aws/services/eks.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/aws/services/eks.mdx b/src/content/docs/aws/services/eks.mdx index d9befafd..171f5e14 100644 --- a/src/content/docs/aws/services/eks.mdx +++ b/src/content/docs/aws/services/eks.mdx @@ -689,7 +689,7 @@ Users can specify the desired version when creating an EKS cluster in LocalStack ## Configuring the k3d Cluster Token When LocalStack creates a k3d-backed EKS cluster, it starts the k3s server with an explicit cluster token. This token is used to authenticate agent nodes joining the cluster, enabling dynamic node registration. -By default, LocalStack uses localstack-k3d-cluster-token as the cluster token. You can override this value using the `EKS_K3D_CLUSTER_TOKEN` configuration variable: +By default, LocalStack uses `localstack-k3d-cluster-token` as the cluster token. You can override this value using the `EKS_K3D_CLUSTER_TOKEN` configuration variable: ```bash EKS_K3D_CLUSTER_TOKEN=my-custom-token localstack start