diff --git a/content/en/references/localstack-on-kubernetes.md b/content/en/user-guide/integrations/kubernetes/index.md
similarity index 87%
rename from content/en/references/localstack-on-kubernetes.md
rename to content/en/user-guide/integrations/kubernetes/index.md
index 8ec7ed48b7..e604d67f68 100644
--- a/content/en/references/localstack-on-kubernetes.md
+++ b/content/en/user-guide/integrations/kubernetes/index.md
@@ -1,17 +1,17 @@
 ---
-title: LocalStack on Kubernetes
+title: Kubernetes
+linktitle: Kubernetes
 weight: 50
-categories: ["LocalStack Community", "LocalStack Pro"]
-tags:
-- kubernetes
-- k8s
-description: >
-  Running LocalStack on Kubernetes
+description: Running LocalStack on Kubernetes
+aliases:
+  - /references/localstack-on-kubernetes/
 ---
 
-LocalStack can be deployed on [Kubernetes](https://kubernetes.io/) using the [LocalStack Helm chart](http://helm.localstack.cloud/).
+## Introduction
 
-## Helm Chart
+[Kubernetes](https://kubernetes.io/) is an open-source container orchestration platform that simplifies the deployment, scaling, and management of containerized applications. LocalStack can be deployed on [Kubernetes](https://kubernetes.io/) using the [LocalStack Helm chart](http://helm.localstack.cloud/).
+
+## Getting started
 
 To deploy LocalStack in your [Kubernetes](https://kubernetes.io/) cluster, you can use [Helm](https://helm.sh/).
 
@@ -50,9 +50,9 @@ Some useful Helm client commands are:
 -   Install a chart: `helm install <name> localstack/<chart>`
 -   Upgrade your application: `helm upgrade`
 
-## Sample repository (`l8k`)
+## LocalStack on Kubernetes (`l8k`)
 
-The [`localstack-on-k8s](https://github.com/localstack/localstack-on-k8s) sample repository that illustrates running LocalStack on Kubernetes (k8s).
+The [`localstack-on-k8s`](https://github.com/localstack/localstack-on-k8s) sample repository illustrates running LocalStack on Kubernetes (k8s).
 
 ### Prerequisites