Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Deploying Tempo

Tempo can be easily deployed through a number of tools as explained in this document.

Note: The Tanka and Helm examples are equivalent. They are both provided for people who prefer different configuration mechanisms.

Tanka / Jsonnet

The Jsonnet files that you need to deploy Tempo with Tanka are available here:

Here are a few examples that use official Jsonnet files. They display the full range of configurations available to Tempo.


Helm charts are available in the grafana/helm-charts repo:

Kubernetes manifests

You can find a collection of Kubernetes manifests to deploy Tempo in the operations/kube-manifests folder. These are generated using the Tanka / Jsonnet.

Deployment scenarios

Tempo can be deployed in one of three modes.

  • Single binary
  • Scalable single binary
  • Microservices

Which mode is deployed is determined by the runtime configuration target, or by using the -target flag on the command line. The default target is all, which is the single binary deployment mode.

Single binary

A single binary mode deployment runs all top-level components in a single process, forming an instance of Tempo. The single binary mode is the simplest to deploy, but can not horizontally scale out by increasing the quantity of components. Refer to Architecture for descriptions of the components.

To enable this mode, -target=all is used, which is the default.

Find docker-compose deployment examples at:

Scalable single binary

A scalable single binary deployment is similar to the single binary mode in that all components are deployed within one binary. Horizontal scale out is achieved by instantiating more than one single binary. This mode offers some flexibility of scaling without the configuration complexity of the full microservices deployment.

Each of the queriers will perform a DNS lookup for the frontend_address and connect to the addresses found within the DNS record.

To enable this mode, -target=scalable-single-binary is used.

Find a docker-compose deployment example at:


In microservices mode, components are deployed in distinct processes. Scaling is per component, which allows for greater flexibility in scaling and more granular failure domains. This is the preferred method for a production deployment, but it is also the most complex

The configuration associated with each component’s deployment specifies a target. For example, to deploy a querier, the configuration would contain target: querier. A command-line deployment may specify the -target=querier flag. Each of the components referenced in Architecture must be deployed in order to get a working Tempo instance.

Find a docker-compose deployment example at: