Welcome to Terracotta

Use cases

  1. Use it as data exploration tool to quickly serve up a folder containing GeoTiff images with terracotta serve.

  2. Make it your tile server backend on an existing webserver. You can ingest your data ahead of time (recommended) or on-demand.

  3. Deploy it on serverless architectures such as AWS Lambda to serve tiles from S3 buckets. This allows you to build apps that scale almost infinitely with minimal maintenance!


If you are using Linux and already have Python 3.8+ installed, all you need to do to check out Terracotta is

$ pip install terracotta[recommended]

Otherwise, see our installation guide for conda-based and development installations on all platforms.

Why Terracotta?

  • It is trivial to get going. Got a folder full of cloud-optimized GeoTiffs in different projections you want to have a look at in your browser? terracotta serve -r {name}.tif and terracotta connect localhost:5000 get you there.

  • We make minimal assumptions about your data, so you stay in charge. Keep using the tools you know and love to create and organize your data, Terracotta serves it exactly as it is.

  • Serverless deployment is a first-priority use case, so you don’t have to worry about maintaining or scaling your architecture.

  • Terracotta instances are self-documenting. Everything the frontend needs to know about your data is accessible from only a handful of API endpoints.


Every Terracotta deployment exposes the API it uses as a swagger.json file and a visual explorer hosted at http://server.com/swagger.json and http://server.com/apidoc, respectively. This is the best way to find out which API your deployment of Terracotta uses.

To catch a first glance, feel free to explore the API of this Terracotta version.