Updates (Helm)

For CARTO Self-hosted using Kubernetes and Helm

This documentation only applies to advanced Orchestrated container deployments using Kubernetes and Helm

Please be informed that our support services are exclusively provided for versions of our product that are less than one year old. It is crucial for the optimal performance, security, and functionality of our software that users maintain up-to-date installations.

We kindly request all users to ensure that their installations are running an updated version. By doing so, you not only ensure access to our support services but also benefit from the latest features, bug fixes, and security enhancements that come with each update.

Download customer package

Once a new release is available, you will need to download the latest customer package.

Clone the CARTO Self-Hosted github repo:

git clone https://github.com/CartoDB/carto-selfhosted.git
cd carto-selfhosted

Checkout to the latest stable release:

git checkout tags/2025.4.9

You should Install the following packages on your machine:yq, jq and gcloud.

Run the script passing the following arguments:

flag	description
-d	Directory containing the existing customer package files.
-s	Carto selfhosted installation mode. Possible values for mode are docker (Single VM deployment) and k8s(Orchestrated container deployment)

./tools/carto-download-customer-package.sh -s k8s -d /tmp/carto

Example output:

ℹ️  selfhosted mode: k8s
✅ found: ../carto3-onprem-customers/package/mcalzado-sh/k8s/carto-values.yaml
✅ found: ../carto3-onprem-customers/package/mcalzado-sh/k8s/carto-secrets.yaml
✅ activating: service account credentials for: [[e-mail]]
ℹ️  latest version: 2025-1-10
ℹ️  download file: gs://carto-tnt-onp-mcalzado-sh-customer-package-storage/customer-package/carto-selfhosted-k8s-customer-package-mcalzado-sh-2025-1-10.zip
Copying gs://carto-tnt-onp-mcalzado-sh-customer-package-storage/customer-package/carto-selfhosted-k8s-customer-package-mcalzado-sh-2025-1-10.zip...
/ [1 files][  3.0 KiB/  3.0 KiB]                                                
Operation completed over 1 objects/3.0 KiB.                                      
✅ downloading: carto-selfhosted-k8s-customer-package-mcalzado-sh-2025-1-10.zip

##############################################################
Current selfhosted version in [carto-values.yaml]: feature/sc-446879/enable-firestore-in-the-carto-sh-licenses-2
Latest selfhosted version downloaded: 2025-1-10
Downloaded file: carto-selfhosted-k8s-customer-package-mcalzado-sh-2025-1-10.zip
Downloaded from: gs://carto-tnt-onp-mcalzado-sh-customer-package-storage/customer-package/carto-selfhosted-k8s-customer-package-mcalzado-sh-2025-1-10.zip
##############################################################

✅ finished [0]

Update

Follow the steps below if you're using an Orchestrated container deployment in Kubernetes.

Steps

1) Update the helm chart:

helm repo update

2) Download the latest customer package

./tools/carto-download-customer-package.sh -d . -s k8s

3) Upgrade the CARTO application

helm upgrade \
  carto \
  carto/carto \
  -f carto-values.yaml \
  -f carto-secrets.yaml \
  -f customizations.yaml