Architecture
Last updated
Was this helpful?
Last updated
Was this helpful?
This documentation is for the CARTO Self-Hosted Legacy Version. Use only if you've installed this specific version. Explore our latest documentation for updated features.
Depending on your chosen cloud provider and type of deployment, there can be different possible architectural setups to deploy CARTO Self-Hosted as illustrated below.
The following diagram describes the different components of the CARTO Self-hosted. This set of components maps both with a container or external service in the deployment.
metadata-database
PostgreSQL database to manage the metadata of the CARTO platform.
Subscribers and APIs use this database to perform their operations.
message-broker
Message broker to exchange messages between the different pieces of the platform using the producer-consumer paradigm.
CARTO Self-Hosted can work without this cache, the platform will just fall back the queries against the metadata database.
It's the root path (https://carto.mycompany.com) of the Self-Hosted, a basic nginx container with static files like HTML, CSS, and JS.
The Web Application manages the login and signup process. It's a modularized React application.
It's at /acc/ path (https://carto.mycompany.com/acc) of the Self-Hosted, a basic nginx container with static files like HTML, CSS, and JS.
It requires a connection with the CARTO accounts API to perform different operations: create accounts, create users, invite users, etc.
API to support the Web Application of the workspace (workspace-www).
It doesn't perform batch operations. Batch operations of SQL API are executed by sql-worker.
You should create multiple instances of this container to scale at your needs.
Consumer of the messages related to workspace at the Message Broker. It reads the messages published on that bus and performs the required actions.
It requires 8GB of RAM to process up to 1GB of geospatial files.
This worker is mainly used to execute SQL in batch for customers using PostgreSQL or Redshift. BigQuery and Snowflake data warehouse won't use this component as it uses the batch APIs (jobs) provided by the data warehouse.
It's the principal entry point of the application. It's an to route the HTTPs traffic to the right components.
More info at the section in .
APIs or scheduler processes often produce messages to be consumed by the subscriber. For example, produces a message to import a file, and the import-worker consumes the message and performs the import operation.
It's not a container included in the Self-Hosted, it uses .
In-memory cache for the APIs and subscribers.
You can use an external service of your cloud provider as explained in more detail .
The Web Application of the workspace. It's a modularized React application. Applications in the CARTO platform such as or are inside this container.
An HTTP cache that works as a CDN for the and some endpoints of . It uses HTTP Cache.
and high-performance API. It's the component with higher traffic as it's deeply used by other components.
. This component doesn't perform actual import operation, it just creates jobs for
) API.
Consumer of the messages related to at the Message Broker. It uploads geospatial files into the customer Data Warehouse.
Consumer of the messages related to at the Message Broker.
Consumer of the messages related to invalidation at the Message Broker. It invalidates content at .
