Deploy Tempo locally

Thu, 09 Apr 2026 14:59:14 +0000

Deploy Tempo locally

You can deploy Tempo This section provides instructions for deploying Tempo locally using Tanka and Jsonnet or using Docker Compose.

Deploy on Linux
Learn how to deploy a single Tempo instance on a single node on Linux.
Deploy Tempo using Docker Compose
Instructions for deploying Tempo using Docker Compose

Note
Grafana Tempo does not come with any included authentication layer. You must run an authenticating reverse proxy in front of your services to prevent unauthorized access to Tempo (for example, nginx). Manage authentication for more details

Deploy Tempo on Kubernetes

Thu, 09 Apr 2026 14:59:14 +0000

Deploy Tempo on Kubernetes

Kubernetes manages distributed deployments and provides orchestration for containerized applications.

Kubernetes offers several deployment options for Tempo:

Helm charts: Package manager approach for installation and configuration
Tempo Operator: Kubernetes-native operator for managing Tempo deployments
Tanka/Jsonnet: Configuration management using Jsonnet templating
Kubernetes manifests: Direct YAML configuration files

Choose the method that best fits your Kubernetes workflow and operational requirements.

Note
Grafana Tempo does not come with any included authentication layer. You must run an authenticating reverse proxy in front of your services to prevent unauthorized access to Tempo (for example, nginx). Manage authentication for more details

Helm

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

In addition, several Helm chart examples are available in the Tempo repository.

Kubernetes Tempo Operator

The operator is available in grafana/tempo-operator repository. The operator reconciles TempoStack resource to deploy and manage Tempo microservices installation.

Refer to the operator documentation for more details.

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.

Refer to Deploy on Kubernetes with Tanka for an example installation using Tanka.

Kubernetes manifests

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

Deploy Tempo on Grafana Labs

Deploy Tempo locally

Deploy Tempo locally

Deploy Tempo on Kubernetes

Deploy Tempo on Kubernetes

Helm

Kubernetes Tempo Operator

Tanka/Jsonnet

Kubernetes manifests