License / Customer Package

License and customer package requirements for CARTO Self-Hosted

Overview

To deploy CARTO Self-Hosted, you need a valid license and customer package provided by CARTO. If you don't have one yet, contact [e-mail].

What's in the customer package

The CARTO Support team will provide your customer package and guide you through the initial setup. Contact [e-mail] to request your package and receive deployment instructions specific to your environment.

Depending on your deployment method, the package includes different files:

☸️ Kots (Admin Console)

Kots

• A license file (.yaml) — provided by CARTO Support and uploaded to the Kots Admin Console during installation

The CARTO Support team will share the license file and provide the Replicated channel URL and any environment-specific instructions needed to complete your installation.

🛞 Helm (customizations.yaml)

Helm

• carto-values.yaml — base configuration values for your CARTO release

• carto-secrets.yaml — your license credentials and private registry access

The CARTO Support team will share these two files along with the Helm chart version to use and any environment-specific instructions needed to complete your installation.

License validation

CARTO Self-Hosted validates your license against CARTO licensing servers. The license is tied to the domain you configure for your deployment.

If your license expires, CARTO Self-Hosted will stop working entirely. Ensure you have a renewal process in place before the expiry date.

Viewing your license

How to view your license details depends on your deployment method:

☸️ Kots (Admin Console)

Kots

Open the Admin Console and navigate to License. The license card shows the license name, type, channel, and expiry status. Click See license details to view the full list of entitlements.

For any questions about your license (renewals, entitlements, or domain changes), contact [e-mail].

🛞 Helm (customizations.yaml)

Helm

Your license is contained in the carto-secrets.yaml file provided by CARTO.

For any questions about your license (renewals, entitlements, or domain changes), contact [e-mail].

Checklist

• You have received your CARTO customer package from support

• You have verified your license is valid for your deployment domain

• You know where to check your license status (Admin Console or via support)