Apply configuration changes

Change a configuration value on an existing CARTO Self-Hosted deployment and re-deploy, without changing the release version

Use this procedure to change a configuration value — a domain, database endpoint, storage bucket, SSO setting, AI key, and so on — on an existing deployment. This is an apply changes (reconfigure) operation: it re-deploys your installation with the new settings without moving to a new release version. To move to a newer version instead, see Updates.

For how configuration is structured and stored in each method, see How Configuration Works. For recommendations on tracking and securing it, see Manage configuration as code.

Kots

Kots

Configuration changes are made in the Admin Console.

1. Log in to the Admin Console.

2. Open the Config tab.

3. Edit the settings you need to change.

4. Click Save config.

5. Wait for the Preflight checks to complete.

6. Click the Deploy button to apply the new configuration.

7. Monitor progress in the Details section until all services are healthy.

The previous configuration stays available in the Version history tab, where you can review the diff between versions or redeploy an earlier one if needed.

Helm

Verify the change

After applying, confirm the deployment is healthy:

• All pods are in Running or Completed state

• The CARTO application is reachable and you can log in

• The setting you changed is reflected in the platform