Deploy Tempo locally

Thu, 28 May 2026 17:50:33 +0100

Deploy Tempo locally

This section provides instructions for deploying Tempo locally using Docker Compose or directly on a Linux host.

You can download the latest version from the Tempo Releases page.

Deploy on Linux
Learn how to install and configure a single Grafana Tempo instance on Linux in monolithic mode with local storage.
Deploy Tempo using Docker Compose
Instructions for deploying Tempo using Docker Compose

Note
Grafana Tempo doesn’t 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, 28 May 2026 17:50:33 +0100

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 doesn’t 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-community/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