> For the complete documentation index, see [llms.txt](https://docs.carto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.carto.com/carto-self-hosted.md).

# CARTO Self-Hosted

- [Overview](https://docs.carto.com/carto-self-hosted/overview.md): Deploy the full CARTO platform on your own infrastructure.
- [Getting Started](https://docs.carto.com/carto-self-hosted/getting-started.md): Orient yourself with CARTO Self-Hosted before planning or deploying
- [Architecture](https://docs.carto.com/carto-self-hosted/getting-started/architecture.md): How CARTO Self-Hosted fits together — components, data flow, and what runs where
- [Responsibility Matrix (RACI)](https://docs.carto.com/carto-self-hosted/getting-started/responsibility-matrix.md): Understand the responsibilities of CARTO vs. your organization
- [Glossary](https://docs.carto.com/carto-self-hosted/getting-started/glossary.md): Key terms and definitions for CARTO Self-Hosted
- [Concepts](https://docs.carto.com/carto-self-hosted/concepts.md): Core concepts behind CARTO Self-Hosted — understand how the platform uses its infrastructure before you configure it
- [Instances, Licenses & Organizations](https://docs.carto.com/carto-self-hosted/concepts/instances-tenants-organizations.md): Understand the relationship between CARTO instances, licenses, and organizations
- [How CARTO uses the Metadata Database](https://docs.carto.com/carto-self-hosted/concepts/metadata-database.md): Understand what CARTO stores in the metadata database and why it matters
- [How CARTO uses Object Storage (blob buckets)](https://docs.carto.com/carto-self-hosted/concepts/object-storage.md): Understand how CARTO uses object storage (blob buckets) across cloud providers
- [How CARTO uses Caches](https://docs.carto.com/carto-self-hosted/concepts/in-memory-cache.md): Distinguish CARTO's two caching layers — the user-facing HTTP cache (Varnish) and the internal in-memory store (Valkey)
- [Metadata Database vs. Data Warehouse](https://docs.carto.com/carto-self-hosted/concepts/metadata-database-vs-data-warehouse.md): Understand the difference between CARTO's metadata database and the data warehouse
- [How Configuration Works](https://docs.carto.com/carto-self-hosted/concepts/configuration-management.md): Understand how configuration works in CARTO Self-Hosted, and how it differs between Helm and Kots
- [Plan Your Deployment](https://docs.carto.com/carto-self-hosted/planning.md): Plan your CARTO Self-Hosted deployment before you install
- [Deployment Methods](https://docs.carto.com/carto-self-hosted/planning/deployment-methods.md): Understand the available CARTO Self-Hosted deployment methods
- [Choosing a Deployment Method](https://docs.carto.com/carto-self-hosted/planning/deployment-methods/choosing-a-deployment-method.md): Decide between the Single Virtual Machine, Standard Orchestrated, and Advanced Orchestrated deployment methods
- [Single Virtual Machine deployment](https://docs.carto.com/carto-self-hosted/planning/deployment-methods/single-vm.md): Single Virtual Machine deployment method for CARTO Self-Hosted
- [Standard Orchestrated container deployment](https://docs.carto.com/carto-self-hosted/planning/deployment-methods/kubernetes-kots.md): Standard Orchestrated container deployment (Kubernetes + Kots) for CARTO Self-Hosted
- [Advanced Orchestrated container deployment](https://docs.carto.com/carto-self-hosted/planning/deployment-methods/kubernetes-helm.md): Advanced Orchestrated container deployment (Kubernetes + Helm) for CARTO Self-Hosted
- [Prerequisites & Checklists](https://docs.carto.com/carto-self-hosted/planning/prerequisites.md)
- [License / Customer Package](https://docs.carto.com/carto-self-hosted/planning/prerequisites/license.md): License and customer package requirements for CARTO Self-Hosted
- [Hardware & Software Requirements](https://docs.carto.com/carto-self-hosted/planning/prerequisites/hardware-requirements.md): Hardware and software requirements for CARTO Self-Hosted by deployment method
- [Metadata Database](https://docs.carto.com/carto-self-hosted/planning/prerequisites/metadata-database.md): Metadata database prerequisites for CARTO Self-Hosted
- [Object Storage (blob buckets)](https://docs.carto.com/carto-self-hosted/planning/prerequisites/object-storage.md): Object storage (blob buckets) prerequisites for CARTO Self-Hosted
- [Network](https://docs.carto.com/carto-self-hosted/planning/prerequisites/network.md): Network prerequisites for CARTO Self-Hosted — egress and ingress requirements
- [Egress](https://docs.carto.com/carto-self-hosted/planning/prerequisites/network/egress.md): Outbound network (egress) requirements for CARTO Self-Hosted
- [Ingress](https://docs.carto.com/carto-self-hosted/planning/prerequisites/network/ingress.md): Inbound network (ingress) requirements for CARTO Self-Hosted
- [Capacity Planning & Sizing](https://docs.carto.com/carto-self-hosted/planning/capacity-planning.md): Size your CARTO Self-Hosted deployment for your expected workload
- [Compliance and Security](https://docs.carto.com/carto-self-hosted/planning/compliance-and-security.md): Security considerations and compliance frameworks for CARTO Self-Hosted
- [Quickstarts](https://docs.carto.com/carto-self-hosted/quickstarts.md): Fast, copy-paste deployments for evaluating or prototyping CARTO Self-Hosted
- [Single Virtual Machine deployment](https://docs.carto.com/carto-self-hosted/quickstarts/quickstart-single-vm-kots.md): Get CARTO Self-Hosted running on a single VM with Kots in the shortest time possible
- [Standard Orchestrated container deployment](https://docs.carto.com/carto-self-hosted/quickstarts/quickstart-kubernetes-kots.md): Get CARTO Self-Hosted running on Kubernetes with Kots in the shortest time possible
- [Advanced Orchestrated container deployment](https://docs.carto.com/carto-self-hosted/quickstarts/quickstart-kubernetes-helm.md): Get CARTO Self-Hosted running on Kubernetes with Helm in the shortest time possible
- [Deployment Guides](https://docs.carto.com/carto-self-hosted/deployment.md)
- [Single Virtual Machine deployment](https://docs.carto.com/carto-self-hosted/deployment/single-vm-deployment.md): Deploy CARTO Self-hosted using a Virtual Machine, k0s, and Kots
- [Standard Orchestrated container deployment](https://docs.carto.com/carto-self-hosted/deployment/kubernetes-kots.md): Deploy CARTO Self-hosted using Kubernetes and Kots
- [Advanced Orchestrated container deployment](https://docs.carto.com/carto-self-hosted/deployment/kubernetes-helm.md): Deploy CARTO Self-hosted using Kubernetes and Helm
- [Configuration Guides](https://docs.carto.com/carto-self-hosted/configuration.md): Configure your CARTO Self-Hosted deployment
- [Networking & Publishing](https://docs.carto.com/carto-self-hosted/configuration/networking.md): Configure networking for CARTO Self-Hosted
- [Configure a forward proxy](https://docs.carto.com/carto-self-hosted/configuration/networking/configure-an-external-proxy.md): Route CARTO Self-Hosted outbound traffic through a forward proxy
- [Custom Domains & TLS](https://docs.carto.com/carto-self-hosted/configuration/networking/custom-domains-and-tls.md): Configure custom domains and TLS certificates for CARTO Self-Hosted
- [TLS Offloading](https://docs.carto.com/carto-self-hosted/configuration/networking/tls-offloading.md): Configure TLS offloading for CARTO Self-Hosted
- [End-to-End TLS](https://docs.carto.com/carto-self-hosted/configuration/networking/end-to-end-tls.md): Terminate TLS at the CARTO Router for end-to-end encryption
- [Data & Storage](https://docs.carto.com/carto-self-hosted/configuration/data-and-storage.md): Configure object storage and database settings for CARTO Self-Hosted
- [Configure your own buckets](https://docs.carto.com/carto-self-hosted/configuration/data-and-storage/configure-your-own-buckets.md): Configure CARTO Self-Hosted to use your cloud storage buckets
- [Configure an external in-memory cache](https://docs.carto.com/carto-self-hosted/configuration/data-and-storage/configure-an-external-in-memory-cache.md): For CARTO Self-Hosted
- [Enable the CARTO Data Warehouse](https://docs.carto.com/carto-self-hosted/configuration/data-and-storage/enable-the-carto-data-warehouse.md): For CARTO Self-Hosted
- [Enable Redshift imports](https://docs.carto.com/carto-self-hosted/configuration/data-and-storage/enable-redshift-imports.md): Enable Redshift data imports in CARTO Self-Hosted
- [Security & Cloud Identities](https://docs.carto.com/carto-self-hosted/configuration/security.md): Security and cloud identity configuration for CARTO Self-Hosted
- [Configure Single Sign-On (SSO)](https://docs.carto.com/carto-self-hosted/configuration/security/configure-single-sign-on-sso.md): Configure SSO for your CARTO Self-Hosted instance using Kots or Helm
- [Cloud Identities](https://docs.carto.com/carto-self-hosted/configuration/security/cloud-identities.md): Grant CARTO access to cloud services without long-lived credentials
- [Use Workload Identity in GCP](https://docs.carto.com/carto-self-hosted/configuration/security/cloud-identities/use-workload-identity-in-gcp.md): For CARTO Self-Hosted
- [Use EKS Pod Identity in AWS](https://docs.carto.com/carto-self-hosted/configuration/security/cloud-identities/use-eks-pod-identity-in-aws.md): For CARTO Self-Hosted orchestrated (Kubernetes) deployments — Kots and Helm
- [Configure your custom service account](https://docs.carto.com/carto-self-hosted/configuration/security/configure-your-custom-service-account.md): Use your own GCP service account instead of the CARTO-provisioned one
- [Enable BigQuery OAuth connections](https://docs.carto.com/carto-self-hosted/configuration/security/enable-bigquery-oauth-connections.md): For CARTO Self-Hosted
- [Performance & HA](https://docs.carto.com/carto-self-hosted/configuration/performance-ha.md): Performance tuning and high availability configuration for CARTO Self-Hosted
- [High availability](https://docs.carto.com/carto-self-hosted/configuration/performance-ha/high-availability.md): Configure high availability for CARTO Self-hosted (Kots and Helm)
- [AI Features for Agentic GIS](https://docs.carto.com/carto-self-hosted/configuration/ai-features.md): Configure AI features for CARTO Self-Hosted (Agentic GIS)
- [Configure CARTO AI prerequisites](https://docs.carto.com/carto-self-hosted/configuration/ai-features/configure-carto-ai-prerequisites.md): For CARTO Self-Hosted
- [Basemaps](https://docs.carto.com/carto-self-hosted/configuration/basemaps.md): Configure basemap providers for CARTO Self-Hosted
- [Enable Google Basemaps](https://docs.carto.com/carto-self-hosted/configuration/basemaps/enable-google-basemaps.md): For CARTO Self-Hosted
- [Usage Tracking](https://docs.carto.com/carto-self-hosted/configuration/usage-tracking.md): Track activity data from CARTO Self-Hosted
- [Tracking Activity Data from Public Maps](https://docs.carto.com/carto-self-hosted/configuration/usage-tracking/tracking-activity-data-from-public-maps.md): Track activity data from public maps in CARTO Self-Hosted
- [Operations & Maintenance](https://docs.carto.com/carto-self-hosted/operations.md): Day-2 operations for CARTO Self-Hosted — upgrades, backups, monitoring, and troubleshooting
- [Upgrades](https://docs.carto.com/carto-self-hosted/operations/upgrades.md): Upgrade and key rotation procedures for CARTO Self-Hosted
- [Update to a new version](https://docs.carto.com/carto-self-hosted/operations/upgrades/updates.md): Updating your CARTO Self-Hosted deployment
- [Apply configuration changes](https://docs.carto.com/carto-self-hosted/operations/upgrades/apply-configuration-changes.md): Change a configuration value on an existing CARTO Self-Hosted deployment and re-deploy, without changing the release version
- [Rotating keys](https://docs.carto.com/carto-self-hosted/operations/upgrades/rotating-keys.md): Rotating keys for custom buckets, OAuth connections, basemaps, and API keys
- [Backup & Restore](https://docs.carto.com/carto-self-hosted/operations/backup-and-restore.md): Backup and restore procedures for CARTO Self-Hosted
- [Backups and restore](https://docs.carto.com/carto-self-hosted/operations/backup-and-restore/backups.md): Backing up and restoring your CARTO Self-Hosted deployment
- [Licensing & Admin](https://docs.carto.com/carto-self-hosted/operations/licensing-and-admin.md): Licensing and administration tasks for CARTO Self-Hosted
- [Kots Admin Console](https://docs.carto.com/carto-self-hosted/operations/licensing-and-admin/kots-admin-console.md): Reference for CARTO Self-Hosted Kots Admin Console configuration
- [Change the Admin Console password](https://docs.carto.com/carto-self-hosted/operations/licensing-and-admin/change-admin-console-password.md)
- [Uninstall](https://docs.carto.com/carto-self-hosted/operations/licensing-and-admin/uninstall.md): Uninstalling your CARTO Self-Hosted deployment
- [Troubleshooting](https://docs.carto.com/carto-self-hosted/operations/troubleshooting.md): Diagnose and resolve issues with CARTO Self-Hosted
- [Monitoring & Observability](https://docs.carto.com/carto-self-hosted/operations/troubleshooting/monitoring.md): Observability guidance for CARTO Self-Hosted — what to monitor, alert on, and how to integrate with your monitoring stack
- [Debug mode and logs](https://docs.carto.com/carto-self-hosted/operations/troubleshooting/debug-mode-and-logs.md): Enable debug mode and collect logs for CARTO Self-Hosted
- [Get debug information for support](https://docs.carto.com/carto-self-hosted/operations/troubleshooting/get-debug-information-for-support.md): Collecting debug information for CARTO Support
- [Support](https://docs.carto.com/carto-self-hosted/operations/troubleshooting/support.md): Get support from the CARTO team
- [Technical Reference](https://docs.carto.com/carto-self-hosted/reference.md): Technical reference for CARTO Self-Hosted
- [Component catalog](https://docs.carto.com/carto-self-hosted/reference/component-catalog.md): Detailed descriptions of all CARTO Self-Hosted components
- [Helm chart values reference](https://docs.carto.com/carto-self-hosted/reference/helm-chart-values.md): Complete reference for CARTO Self-Hosted Helm chart configuration values
- [Advanced Helm customizations](https://docs.carto.com/carto-self-hosted/reference/advanced-helm-customizations.md): For CARTO Self-hosted using Kubernetes and Helm
- [Environment variables](https://docs.carto.com/carto-self-hosted/reference/environment-variables.md): Environment variables reference for CARTO Self-Hosted
- [Network ports and endpoints](https://docs.carto.com/carto-self-hosted/reference/network-ports-and-endpoints.md): Network connectivity requirements for CARTO Self-Hosted
- [Compatibility matrix](https://docs.carto.com/carto-self-hosted/reference/compatibility-matrix.md): Supported versions and compatibility information for CARTO Self-Hosted
- [General Best Practices](https://docs.carto.com/carto-self-hosted/best-practices.md): Recommended practices for CARTO Self-Hosted deployments
- [Deployment](https://docs.carto.com/carto-self-hosted/best-practices/deployment.md): Best practices for deploying CARTO Self-Hosted
- [Deployment best practices](https://docs.carto.com/carto-self-hosted/best-practices/deployment/deployment-best-practices.md): Recommendations for deploying CARTO Self-Hosted
- [Load balancing best practices](https://docs.carto.com/carto-self-hosted/best-practices/deployment/load-balancing-best-practices.md)
- [Security](https://docs.carto.com/carto-self-hosted/best-practices/security.md): Best practices for securing CARTO Self-Hosted
- [Security best practices](https://docs.carto.com/carto-self-hosted/best-practices/security/security-best-practices.md): Security recommendations for CARTO Self-Hosted
- [Operations](https://docs.carto.com/carto-self-hosted/best-practices/operations.md): Best practices for operating CARTO Self-Hosted
- [Operations best practices](https://docs.carto.com/carto-self-hosted/best-practices/operations/operations-best-practices.md): Operational recommendations for CARTO Self-Hosted
- [Release Notes](https://docs.carto.com/carto-self-hosted/release-notes.md): For Self-Hosted deployments
- [Legacy](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy.md)
- [Key concepts](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/key-concepts.md)
- [Architecture](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/key-concepts/architecture.md)
- [Deployment requirements](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/key-concepts/deployment-requirements.md)
- [Quickstarts](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/quickstarts.md)
- [Single VM deployment (docker-compose)](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/quickstarts/single-vm-deployment.md)
- [Guides](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides.md)
- [Configure your own buckets](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/configure-your-own-buckets.md)
- [Configure an external in-memory cache](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/configure-an-external-in-memory-cache.md)
- [Enable Google Basemaps](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/enable-google-basemaps.md)
- [Enable the CARTO Data Warehouse](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/enable-the-carto-data-warehouse.md)
- [Configure an external proxy](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/configure-an-external-proxy.md)
- [Enable BigQuery OAuth connections](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/enable-bigquery-oauth-connections.md)
- [Configure Single Sign-On (SSO)](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/configure-single-sign-on-sso.md)
- [Enable Redshift imports](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/enable-redshift-imports.md)
- [Configure your custom service account](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/configure-your-custom-service-account.md)
- [Advanced customizations](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/advanced-customizations.md)
- [Migrating CARTO Self-Hosted installation to an external database](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/guides/migrating-carto-self-hosted-installation-to-an-external-database.md)
- [Maintenance](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/maintenance.md)
- [Updates](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/maintenance/updates.md)
- [Backups](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/maintenance/backups.md)
- [Uninstall](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/maintenance/uninstall.md)
- [Rotating keys](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/maintenance/rotating-keys.md)
- [Monitoring](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/maintenance/monitoring.md)
- [Support](https://docs.carto.com/carto-self-hosted/carto-self-hosted-legacy/support.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.carto.com/carto-self-hosted.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.