Instances, Licenses & Organizations

Understand the relationship between CARTO instances, licenses, and organizations

Overview

CARTO Self-Hosted involves licensing at two distinct levels, and it helps to keep them separate:

• A platform license activates the deployment itself — the right to run CARTO Self-Hosted.

• Each organization inside the deployment has its own license that defines its quotas and entitlements — how many users, map loads, and connections it gets, and which features it can use.

This page explains the instance, the platform license, and organizations, and how to use them to structure environments — for example, a separate instance for development and another for production.

Key concepts

Instance

A CARTO instance is a full deployment of the CARTO Self-Hosted platform: a set of services running together, sharing one metadata database, one object storage bucket group, and one in-memory store. Each instance is deployed and managed independently, and instances are fully isolated from one another — they do not share data, configuration, or users.

Platform license

A platform license activates an instance: it grants the right to run CARTO Self-Hosted, is validated against CARTO's licensing servers, and is tied to the domain you configure. If it expires, the platform stops working. You apply it during initial setup — see License / Customer Package.

Each instance requires its own platform license. This is separate from the per-organization licensing described below.

Internally, an instance's organizations are grouped under a single tenant that is created automatically during setup. You do not configure or manage tenants in CARTO Self-Hosted.

Organization

An organization is a self-contained workspace within an instance — its own users and roles, data connections, maps, workflows, and dashboards. It is the boundary for access control, sharing, and collaboration in CARTO.

Each organization has its own license that defines its quotas and entitlements: the number of users, map loads, and connections it can use, and which features it has access to. These quotas are tracked per organization — independently of the platform license that runs the deployment. An instance can host one or more organizations, each with its own license and quotas, letting you segment teams, business units, or projects. Most Self-Hosted deployments run a single organization.

Within an organization you manage:

• Users and roles (Admin, Editor, Viewer)

• Shared data connections

• Maps, workflows, and dashboards

Dev / Prod environment design

The recommended pattern for CARTO Self-Hosted is to run separate instances for development and production environments. This provides full isolation between environments, including independent databases, storage, and configuration.

Each instance requires its own platform license. Contact [e-mail] if you need licenses for multiple environments.

Next steps

• Plan Your Deployment — naming conventions, environment design decisions, prerequisites, and deployment method selection