From 63792a4167244b7eac31e6e64d90faf31d35c3ed Mon Sep 17 00:00:00 2001
From: epalchenko <ypalchenko@thingsboard.io>
Date: Fri, 5 Jun 2026 18:17:06 +0300
Subject: [PATCH 1/2] add Minikube section to CE-to-PE upgrade guide and fix
 license key instructions

---
 .../installation/minikube-cluster-setup.mdx   |  4 +-
 .../docs/pe/installation/upgrade-from-ce.mdx  | 61 ++++++++++++++++++-
 2 files changed, 62 insertions(+), 3 deletions(-)

diff --git a/src/content/docs/docs/pe/installation/minikube-cluster-setup.mdx b/src/content/docs/docs/pe/installation/minikube-cluster-setup.mdx
index 12d16210b4..ff5f07e854 100644
--- a/src/content/docs/docs/pe/installation/minikube-cluster-setup.mdx
+++ b/src/content/docs/docs/pe/installation/minikube-cluster-setup.mdx
@@ -65,11 +65,11 @@ Edit the ThingsBoard node configuration:
 nano tb-node.yml
 ```
 
-Find the `TB_LICENSE_SECRET` environment variable and replace `PUT_YOUR_LICENSE_SECRET_HERE` with your actual license secret:
+Find the `TB_LICENSE_SECRET` environment variable and set its `value:` to your actual license secret:
 
 ```yaml
 - name: TB_LICENSE_SECRET
-  value: "PUT_YOUR_LICENSE_SECRET_HERE"
+  value: "YOUR_LICENSE_SECRET"
 ```
 
 ## Step 3. Configure database
diff --git a/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx b/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx
index 49e734ca23..59cc52d7e5 100644
--- a/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx
+++ b/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx
@@ -8,7 +8,7 @@ import DocLink from '@components/DocLink.astro';
 import { Aside } from '@astrojs/starlight/components';
 import { Code } from '@astrojs/starlight/components';
 import { Products } from '~/models/site.models';
-import { PE_FULL_VER, PE_PKG_VER } from '~/data/versions';
+import { PE_FULL_VER, PE_PKG_VER, CE_FULL_VER } from '~/data/versions';
 
 export const ubuntuDownloadCmd = `wget https://dist.thingsboard.io/thingsboard-${PE_PKG_VER}.deb`;
 export const ubuntuInstallCmd = `sudo dpkg -i thingsboard-${PE_PKG_VER}.deb`;
@@ -19,6 +19,9 @@ export const windowsDownloadUrl = `https://dist.thingsboard.io/thingsboard-windo
 export const dockerPullCmd = `docker pull thingsboard/tb-pe-node:${PE_FULL_VER}
 docker pull thingsboard/tb-pe-web-report:${PE_FULL_VER}`;
 
+export const k8sLicenseCmd = `- name: TB_LICENSE_SECRET\n  value: "YOUR_LICENSE_SECRET"`;
+export const k8sCloneCmd = `git clone -b release-${CE_FULL_VER} https://github.com/thingsboard/thingsboard-pe-k8s.git --depth 1\ncd thingsboard-pe-k8s/minikube`;
+
 ## Ubuntu
 
 <Aside type="caution">
@@ -194,3 +197,59 @@ Run the upgrade and start the services:
 ./docker-upgrade-tb.sh --fromVersion=CE
 ./docker-start-services.sh
 ```
+
+## Minikube
+
+<Aside type="caution">
+These upgrade steps are applicable for the **latest** ThingsBoard Community Edition version. You must <DocLink product={Products.CE} path="installation/upgrade-instructions">upgrade to the latest Community Edition version first</DocLink>.
+</Aside>
+
+For AWS EKS, Azure AKS, or GCP GKE refer to the corresponding <DocLink product={Products.PE} path="installation">PE installation guides</DocLink>.
+
+### Stop ThingsBoard CE resources
+
+```bash
+./k8s-delete-resources.sh
+```
+
+### Switch to PE Kubernetes scripts
+
+PE uses a separate repository with additional components. Clone the PE scripts into a separate directory:
+
+<Code code={k8sCloneCmd} lang="bash" />
+
+Copy your custom settings from the CE configuration (database type, hosts, environment variables, volumes) into the corresponding PE files.
+
+In `tb-node.yml`, find `- name: TB_LICENSE_SECRET` and set its `value:` to your license secret:
+
+<Code code={k8sLicenseCmd} lang="yaml" />
+
+See <a href="https://www.youtube.com/watch?v=dK-QDFGxWek" target="_blank">How-to get pay-as-you-go subscription</a> or <a href="https://www.youtube.com/watch?v=GPe0lHolWek" target="_blank">How-to get perpetual license</a> for more details.
+
+### Run the database upgrade
+
+```bash
+./k8s-upgrade-tb.sh --fromVersion=CE
+```
+
+<Aside type="note">
+The upgrade script creates a temporary `tb-db-setup` pod using the image from `database-setup.yml`. All third-party services (Zookeeper, Kafka, Valkey, PostgreSQL, and Cassandra if using the `hybrid` database mode) must be in `Running` state before executing this command. Check pod status with:
+
+```bash
+kubectl get pods -n thingsboard
+```
+</Aside>
+
+### Deploy ThingsBoard PE resources
+
+```bash
+./k8s-deploy-resources.sh
+```
+
+### Verify the upgrade
+
+Wait until all pods are running:
+
+```bash
+kubectl get pods -n thingsboard
+```

From 49c35e77a0eafba2a86d07264db41a42831d69fb Mon Sep 17 00:00:00 2001
From: epalchenko <ypalchenko@thingsboard.io>
Date: Mon, 8 Jun 2026 10:48:23 +0300
Subject: [PATCH 2/2] Updated docs for upgrading from CE to PE Kubernetes

---
 src/content/docs/docs/pe/installation/upgrade-from-ce.mdx | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx b/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx
index 59cc52d7e5..be55df0211 100644
--- a/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx
+++ b/src/content/docs/docs/pe/installation/upgrade-from-ce.mdx
@@ -7,6 +7,7 @@ description: "Instructions for upgrading ThingsBoard from Community Edition to P
 import DocLink from '@components/DocLink.astro';
 import { Aside } from '@astrojs/starlight/components';
 import { Code } from '@astrojs/starlight/components';
+import { k8sCloneCmd } from '~/util/install-commands';
 import { Products } from '~/models/site.models';
 import { PE_FULL_VER, PE_PKG_VER, CE_FULL_VER } from '~/data/versions';
 
@@ -20,7 +21,7 @@ export const dockerPullCmd = `docker pull thingsboard/tb-pe-node:${PE_FULL_VER}
 docker pull thingsboard/tb-pe-web-report:${PE_FULL_VER}`;
 
 export const k8sLicenseCmd = `- name: TB_LICENSE_SECRET\n  value: "YOUR_LICENSE_SECRET"`;
-export const k8sCloneCmd = `git clone -b release-${CE_FULL_VER} https://github.com/thingsboard/thingsboard-pe-k8s.git --depth 1\ncd thingsboard-pe-k8s/minikube`;
+export const cloneCmd = k8sCloneCmd('pe', 'minikube');
 
 ## Ubuntu
 
@@ -216,7 +217,7 @@ For AWS EKS, Azure AKS, or GCP GKE refer to the corresponding <DocLink product={
 
 PE uses a separate repository with additional components. Clone the PE scripts into a separate directory:
 
-<Code code={k8sCloneCmd} lang="bash" />
+<Code code={cloneCmd} lang="bash" />
 
 Copy your custom settings from the CE configuration (database type, hosts, environment variables, volumes) into the corresponding PE files.