Builder is the web management component of CARTO. Within Builder you can find all the features available in CARTO. These are some of the most significant tasks you can do with Builder:

  • User management. Credentials, authorization, personal info and billing.
  • Connect datasets to your CARTO account either by importing your datasets or other ones publicly available.
  • Create maps from your datasets
  • Publising and permissions management of datasets and maps
  • Synchronized tables management

InternallyBuilder is the operations core of CARTO. It manages PostgreSQL metadata database, keep some metadata in sync with Redis, manages new datasets import queues with resque, etc..

It is developed in Ruby on Rails and like the other components of CARTO is Open Source and you can find the source code at CartoDB/cartodb

You can find usage documentation at

Although you can chechout any branch of the repository most of them are usually work in progress that is not guaranteed to work. In order to run a production ready Editor service you need to use master branch.

Service modesΒΆ

The code of CARTO Builder needs to run in two different modes. HTTP server mode and background jobs mode.

The HTTP server processes the http requests sent to the service and returns a response synchronously. Any ruby rack server can be used to start the Builder in this mode. Some examples of rack servers are mongrel, webrick, thin or unicorn.

The background jobs mode is started with resque. In this mode the service keep polling some redis keys in order to find pending background jobs. When it finds one, it processes it and change the state of the job in redis. CARTO uses this mode for different type of jobs like datasets imports or synchronized tables.