Overview
Last updated
Was this helpful?
Last updated
Was this helpful?
In many scenarios, organizations will need to deploy the whole CARTO platform in their own infrastructure. For example:
When access to their data warehouse is very restrictive.
When they are not able to configure the credentials to connect with their data warehouse in the CARTO Cloud service.
When their data warehouse is within a virtual private cloud (VPC) or behind a virtual private network (VPN)
In order to cover these and other situations, CARTO has made available the option of a self-hosted deployment. This is for example a common option for businesses in the healthcare, telco, insurance, and finance industries to remain compliant to their strict security and network policies.
CARTO Self-hosted can be deployed locally and on several cloud infrastructure providers such as GCP, AWS or Azure. See the deployment overview for a full list of options and installation instructions.
CARTO Self-hosted can run on a variety of platforms using a set of Docker images. The available deployment methods vary in complexity and scalability, so you can choose between a Single VM deployment, an Orchestrated container deployment, or an Advanced Orchestrated container deployment, based on your requirements and use case. There is no better or preferred method, it depends on your needs.
KOTS (Kubernetes Off-The-Shelf) and Helm are both tools for managing Kubernetes deployments, but they serve different purposes depending on ease of use and customization requirements:
KOTS focuses on simplifying the deployment of pre-packaged Kubernetes applications, particularly for self-hosted environments. It includes features like built-in admin consoles, automated updates, and configuration management aimed at non-expert Kubernetes users. KOTS simplifies deploying CARTO Self-hosted by providing an Admin Console with key features such as:
Updates can be applied with a single click, streamlining maintenance.
Configuration changes are managed through a user-friendly UI with built-in versioning, ensuring easy tracking and rollbacks.
Support bundles can be generated instantly, simplifying troubleshooting.
Additionally, license synchronization is automated, reducing manual overhead and ensuring compliance effortlessly.
Helm is a package manager for Kubernetes, allowing users to define, install, and upgrade applications using charts—pre-configured Kubernetes resources. It excels at templating and managing app lifecycles in a declarative manner. Helm provides full control over advanced customizations of the CARTO Self-hosted deployment, allowing users to tailor deployments beyond the options available in the KOTS UI, making it ideal for complex, highly specific configurations.
As it has been mentioned before in this document, CARTO Self-hosted is distributed in different ways depending on customer requirements. Continue reading for more details about each deployment type.
CARTO is deployed in a single VM using an embedded cluster and Kots. This deployment is the easiest and fastest.
Follow the Guides (Kots) and Maintenance (Kots) documentation pages for this type of deployment. Take a look at the Quickstart page for an installation guide using this method.
This method might be appropriate if you and your team:
Are currently evaluating CARTO or deploying CARTO for the first time.
Have less experience with Kubernetes or DevOps concepts.
Need a lightweight, low-cost, and low-maintenance deployment method.
Would like to deploy CARTO on a small-scale or single-server environment.
CARTO can be deployed in an orchestrated environment using Kubernetes. This method uses Kots to manage the configuration and maintenance of the deployment.
Follow the Guides (Kots) and Maintenance (Kots) documentation pages for this type of deployment.
Take a look at the Quickstart page for an installation guide using this method.
This method might be appropriate if you and your team:
Already use Kubernetes to deploy other applications.
Have experience with Docker or DevOps concepts.
Require scalability, high availability, and resilience.
Prefer to use a UI for most configuration and maintenance tasks.
We support deployments with the following Kubernetes vendors:
Google Kubernetes Engine (GKE)
Amazon Elastic Kubernetes Service (EKS)
Microsoft Azure Kubernetes Service (AKS)
Red Hat OpenShift
IBM Cloud Kubernetes Service
If your Kubernetes vendor is not listed, please reach out to our support team for assistance: support@carto.com
CARTO can be deployed in an orchestrated environment using Kubernetes. This method uses a Helm chart to manage the configuration and maintenance of the deployment.
Follow the Guides (Helm) and Maintenance (Helm) documentation pages for this type of deployment.
Take a look at the Quickstart page for an installation guide using this method.
This method might be appropriate if you and your team:
Already use Kubernetes to deploy other applications.
Have experience with Docker or DevOps concepts.
Require scalability, high availability, and resilience.
Are familiar with Helm charts and can fully handle an installation process from a terminal.
We support deployments with the following Kubernetes vendors:
Google Kubernetes Engine (GKE)
Amazon Elastic Kubernetes Service (EKS)
Microsoft Azure Kubernetes Service (AKS)
Red Hat OpenShift
IBM Cloud Kubernetes Service
If your Kubernetes vendor is not listed, please reach out to our support team for assistance: support@carto.com
CARTO Self-hosted offers flexibility in the installation process to accommodate a range of customer preferences and infrastructure complexities. For customers with technical expertise and a straightforward setup, we offer a Self-Service installation option, enabling you to independently install and configure the product using our comprehensive installation guides.
However, we understand some organizations may have intricate setups such as Virtual Private Cloud (VPC), VPN, restricted network access, HTTPS proxy, or other specialized requirements. In such cases, we offer Assisted installations, where our expert team collaborates closely with you to ensure a seamless and tailored deployment. Our goal is to provide a solution that fits your specific needs, regardless of the level of installation assistance required.
If you require an Assisted installation, please book time with us.
Architecture
Learn more about the different possible architectures for deploying CARTO Self-hosted.
Deployment requirements
Gather more information about the requirements for your deployment.
Quickstarts
Deploy CARTO Self-Hosted in GCP, AWS, Azure.
Guides
Detailed guides to configure different components of a Self-hosted deployment.
Maintenance
Manage updates, backups and details on how to get support for your Self-hosted deployment.
Release Notes
Relevant changes that are introduced in each specific CARTO Self-hosted release version.
