Installation

The CARTO CLI is published on npm as @carto/carto-cli and installs as a global carto binary.

Prerequisites

• Node.js 22 or newer. Check with node --version.

• A CARTO organization. The CLI works against CARTO Cloud (any region) and CARTO Self-Hosted deployments.

CARTO Self-Hosted compatibility

The CARTO CLI evolves with the rest of the CARTO Platform. The latest version of the CARTO CLI will always be compatible with CARTO Cloud. However, newer versions of the CLI might not be compatible with older versions of CARTO Self-Hosted deployments, due to missing API functionalities.

For a full compatibility list, check the CARTO Self-Hosted release notes.

Install via npm

npm install -g @carto/carto-cli

Verify the install:

carto --version
carto --help

Upgrade

npm install -g @carto/carto-cli@latest

Next steps

• Authenticate to your CARTO organization with carto auth login.

• If you manage multiple CARTO organizations or environments, set up named profiles.