Updates

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.

Single VM deployment

To upgrade your CARTO Self-Hosted deployment, simply access the Admin Console and check for any available updates.

Upgrade CARTO version

1. Login to the Admin Console.

2. Click on "Check for Updates" link.

3. If there are new SelfHosted version availabile, you will see it in the "New version available" section in the Admin Console.

4. Wait for the Preflight Checks to Complete.

1. Click on the blue "Deploy" button to deploy your new version.

2. Monitor the progres in the "Details" section.

Once the update has been downloaded and all the preflight checks have completed successfully, initiate the upgrade process by clicking the “Deploy” button. Upon completion of the deployment, your single VM deployment will be successfully updated to the latest version.

Orchestrated container deployment (Kots in K8s)

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

Upgrade CARTO version

1. Login to the Admin Console.

2. Click on "Check for Updates" link.

3. If there are new SelfHosted version availabile, you will see it in the "New version available" section in the Admin Console.

4. Wait for the Preflight Checks to Complete.

1. Click on the blue "Deploy" button to deploy your new version.

2. Monitor the progres in the "Details" section.

Once the update has been downloaded and all the preflight checks have completed successfully, initiate the upgrade process by clicking the “Deploy” button. Upon completion of the deployment, your CARTO Deployment i K8s with Kots will be successfully updated to the latest version.

(Optional) Upgrade Kots Admin-Console

In some cases, you may need to update the KOTS Admin Console to ensure compatibility with the latest CARTO Self-Hosted release or to receive important fixes. This process should always be performed independently of the CARTO upgrade to avoid conflicts or delays.

When should I upgrade KOTS?

• When required by the Admin Console during the upgrade process: If your Kots version is below our minimum version you'll have to upgrade the Admin Console version before upgrading CARTO. You can view our minKotsVersion value here.

• Release notes notification: We recommend upgrade KOTS when explicitly required in the CARTO release notes. These notes will clearly specify the exact version of KOTS that has been validated by CARTO.

• Do not upgrade on your own: Avoid upgrading KOTS independently (e.g., every X months). Running unvalidated versions may introduce incompatibilities.

Steps to upgrade KOTS:

1. Update the Kots version in your local machine to match the one specified in the release notes:

export VERSION="<kots-version-in-release-notes>"
curl https://kots.io/install/${VERSION} | bash

1. Update the Kots version in the cluster:

kubectl kots admin-console upgrade -n <namespace>