Comment on page

Updates

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/2023.10.25
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.env and key.json 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 -d /tmp/carto -s <mode>
Example output (using docker mode):
ℹ️ selfhosted mode: docker
✅ found: /tmp/carto/carto-values.yaml
✅ found: /tmp/carto/carto-secrets.yaml
✅ activating: service account credentials for: [[email protected]]
Copying gs://carto-tnt-onp-xxx-client-storage/customer-package/carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip...
/ [1 files][  2.6 KiB/  2.6 KiB]
Operation completed over 1 objects/2.6 KiB.
✅ downloading: carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip
​
##############################################################
Current selfhosted version in [carto-values.yaml]: 2023.6.16
Latest selfhosted version downloaded: 2023-6-16
Downloaded file: carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip
Downloaded from: gs://carto-tnt-onp-xxx-client-storage/customer-package/carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip
##############################################################
​
✅ finished [0]
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:
cd carto-selfhosted
git fetch
git checkout tags/2023.10.25
2) Save a backup copy of your current customer.env:
mv customer.env customer.env.bak
3) Download the latest customer package (containing customer.env and key.json files):
./tools/carto-download-customer-package.sh -d . -s docker
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
bash install.sh
Recreate the containers:
docker-compose up -d
Orchestrated container deployment
Follow the steps below if you're using an Orchestrated container deployment in Kubernetes.
Update 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

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

CARTO Self-Hosted - Previous

Maintenance

Uninstall

Last modified 8d ago