diff --git a/content/en/references/localstack-on-kubernetes.md b/content/en/user-guide/integrations/kubernetes/index.md
similarity index 80%
rename from content/en/references/localstack-on-kubernetes.md
rename to content/en/user-guide/integrations/kubernetes/index.md
index 8ec7ed48b7..46ac212c3b 100644
--- a/content/en/references/localstack-on-kubernetes.md
+++ b/content/en/user-guide/integrations/kubernetes/index.md
@@ -1,17 +1,25 @@
 ---
-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 using the [LocalStack Helm chart](http://helm.localstack.cloud).
+
+{{< alert title="Warning" color="warning" >}}
+Creating shared/hosted LocalStack instances may have some licensing implications. For example, a valid license might be necessary for each user who interacts with the instance. If you have any questions or uncertainties regarding the licensing implications, we encourage you to [contact us](https://localstack.cloud/contact) for further details.
+{{< /alert >}}
+
+{{< alert title="Note" >}}
+LocalStack on Kubernetes can be used in conjunction with the [LocalStack Community image](https://hub.docker.com/r/localstack/localstack). However, specific features such as execution of Lambda functions as Kubernetes pods is only available in the [LocalStack Pro image](https://hub.docker.com/r/localstack/localstack-pro).
+{{< /alert >}}
+
+## Getting started
 
 To deploy LocalStack in your [Kubernetes](https://kubernetes.io/) cluster, you can use [Helm](https://helm.sh/).
 
@@ -38,7 +46,7 @@ The following command allows you to download and install all the charts from thi
 $ helm repo add localstack https://localstack.github.io/helm-charts
 {{< /command >}}
 
-### Use Helm
+### Using Helm
 
 After you have installed the Helm client, you can deploy a Helm chart into a Kubernetes cluster.
 
@@ -50,9 +58,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
 
@@ -66,7 +74,7 @@ This sample requires the following tools installed on your machine:
 * [`kubectl`](https://kubernetes.io/docs/tasks/tools/#kubectl)
 * [Serverless](https://www.npmjs.com/package/serverless)
 
-### Installation
+### Clone the sample repository
 
 Clone the repository:
 
@@ -90,10 +98,12 @@ After initialization, your `kubectl` command-line should be automatically config
 
 {{< command >}}
 $ kubectl config current-context
+<disable-copy>
 k3d-ls-cluster
+</disable-copy>
 {{< /command >}}
 
-### Deploy a sample application
+### Deploy the sample application
 
 Once LocalStack is installed in the Kubernetes cluster, we can deploy the sample app on the LocalStack instance:
 
@@ -140,7 +150,3 @@ $ awslocal apigateway --endpoint-url=http://localhost:8081 get-rest-apis
 {{< /command >}}
 
 We can then use a browser to open the [Web UI](http://localhost:8081/archive-bucket/index.html), which should have been deployed to an S3 bucket inside LocalStack. The Web UI can be used to interact with the sample application, send new requests to the backend, inspect the state of existing requests, etc.
-
-{{< alert title="Note" >}}
-LocalStack on Kubernetes can be used in conjunction with the [LocalStack Community image](https://hub.docker.com/r/localstack/localstack). However, specific features such as execution of Lambda functions as Kubernetes pods is only available in the [LocalStack Pro image](https://hub.docker.com/r/localstack/localstack-pro).
-{{< /alert >}}