Upgrading KOTS

These instructions apply to all existing clusters except OpenShift with minimal RBAC. For existing OpenShift clusters with minimal RBAC, click here. For embedded clusters, click here.

Upgrading KOTS on an existing cluster - online

First, you need to update the KOTS CLI:

curl https://kots.io/install | bash

Then, the Admin Console needs to be updated as well.

kubectl kots admin-console upgrade -n <namespace>

The field at the very bottom of the page indicates the current KOTS version - it’ll change when the page is refreshed.

Upgrading KOTS on an existing cluster - airgapped

Step 1: Follow the instructions here.
The KOTS CLI version must match the airgap bundle version.

Step 2: Update the Admin Console with:

kubectl kots admin-console push-images ./kotsadm.tar.gz private.registry.host/application-name \ 
  --registry-username rw-username \
  --registry-password rw-password
  
kubectl kots admin-console upgrade \ 
  --kotsadm-registry private.registry.host/application-name \ 
  --registry-username ro-username \ 
  --registry-password ro-password \ 
  -n <namespace> 

These instructions apply only to existing OpenShift clusters with minimal RBAC. For embedded clusters, click here.

Upgrading KOTS on an existing OpenShift cluster with minimal RBAC - online

First, you need to update the KOTS CLI:

curl https://kots.io/install | bash

Then, the Admin Console needs to be updated as well with namespace-scoped access.

kubectl kots admin-console upgrade -n <namespace> --skip-rbac-check --ensure-rbac=false

The field at the very bottom of the page indicates the current KOTS version - it’ll change when the page is refreshed.

Upgrading KOTS on an existing OpenShift cluster with minimal RBAC - airgapped

Step 1: Follow the instructions here.
The KOTS CLI version must match the airgap bundle version.

Step 2: Update the Admin Console with namespace-scoped access:

kubectl kots admin-console push-images ./kotsadm.tar.gz private.registry.host/application-name \ 
  --registry-username rw-username \
  --registry-password rw-password
  
kubectl kots admin-console upgrade \ 
  --kotsadm-registry private.registry.host/application-name \ 
  --registry-username ro-username \ 
  --registry-password ro-password \ 
  -n <namespace> \
  --skip-rbac-check \
  --ensure-rbac=false

These instructions apply only to VM/embedded clusters. For existing clusters click here.

Upgrading KOTS on an embedded cluster - online

First, you need to update the KOTS CLI:

curl https://kots.io/install | sudo bash

Then (only for kURL cluster), the whole cluster needs to be updated, by running this command:

curl -sSL https://kurl.sh/swaggerhub | sudo bash

Upgrading KOTS on an embedded cluster - airgapped

To update the KOTS platform and Admin Console, the customer needs to get the swaggerhub.tar.gz file from the download portal and copy it to the VM. Unpack and install the tar file with:

tar xzvf swaggerhub.tar.gz
cat install.sh | sudo bash -s airgap