Updates (Helm)

For CARTO Self-hosted using Kubernetes and Helm

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

Support lifecycle policy

At CARTO, we are committed to providing reliable, secure, and high-quality support for all our users. To ensure the best experience, our support services are available only for CARTO Self-hosted versions released within the past 12 months.

Maintaining your installation on an up-to-date version is essential to:

• Guarantee optimal performance of the platform.

• Ensure security and compliance through the latest patches.

• Benefit from continuous improvements, including new features and resolved issues.

We strongly recommend that all users regularly update their CARTO installations. Doing so not only secures continued eligibility for support services but also allows you to take full advantage of CARTO’s latest capabilities and innovations.

Keeping your environment current is the best way to maximize the value of your CARTO deployment while ensuring stability, security, and a seamless user experience.

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.9.11

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]

Upgrade SelfHosted CARTO verison

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 (using the repo downloaded in the previous step)

./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