Updates
This documentation is for the CARTO Self-Hosted Legacy Version. Use only if you've installed this specific version. Explore our latest documentation for updated features.
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:
Checkout to the latest stable release:
You should Install the following packages on your machine:yq
, jq
and gcloud
.
Run the script passing the following arguments:
flag | description |
---|---|
| Directory containing the existing customer package files. |
| Carto selfhosted installation mode. Possible values for mode are |
Example output (using docker mode):
Single VM deployment
Follow the steps below if you're using a single VM deployment with Docker Compose.
To update your CARTO Self-hosted to the newest version you will need to run the following commands:
1) Checkout to the latest stable release you want to update:
2) Save a backup copy of your current customer.env
:
3) Download the latest customer package (containing customer.env
and key.json
files):
4) Open side by side customer.env
and customer.env.bak
and apply the customizations from customer.env.bak
in the new customer.env
Generate the .env
file
Recreate the containers:
Orchestrated container deployment
Follow the steps below if you're using an Orchestrated container deployment in Kubernetes.
Update steps
1) Update the helm chart:
2) Download the latest customer package
./tools/carto-download-customer-package.sh -d . -s k8s
3) Upgrade the CARTO application
Last updated