---
title: "Quick start for Tempo | Grafana Tempo documentation"
description: "Use Docker to quickly view traces using K-6 and Tempo"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Quick start for Tempo

The Tempo repository provides [multiple examples](https://github.com/grafana/tempo/tree/main/example/docker-compose) to help you quickly get started using Tempo and tracing data.

Every example has a `docker-compose.yaml` manifest that includes all of the options needed to explore trace data in Grafana, including resource configuration and trace data generation. The Tempo examples running with docker-compose all include a version of Tempo and a storage configuration like Amazon S3 and GCS.

This quick start guide uses the `local` example. Any data is stored locally in the `tempo-data` folder. To learn more, read the [local storage example README](https://github.com/grafana/tempo/blob/main/example/docker-compose/local).

## Before you begin

To follow this guide, you need:

- Git, Docker, and docker-compose plugin

## Clone Tempo and start Docker

1. Clone the Tempo repository:
   
   ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```none
   git clone https://github.com/grafana/tempo.git
   ```
2. Go into the examples directory:
   
   ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```none
   cd tempo/example/docker-compose/local
   ```
3. Start the services that are defined in the docker-compose file:
   
   ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```none
   docker compose up -d
   ```
4. Verify that the services are running using `docker compose ps`. You should see something like:
   
   ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```none
   docker compose ps
   NAME                 COMMAND                  SERVICE             STATUS              PORTS
   local-grafana-1      "/run.sh"                grafana             running             0.0.0.0:3000->3000/tcp
   local-k6-tracing-1   "/k6-tracing run /ex…"   k6-tracing          running
   local-prometheus-1   "/bin/prometheus --c…"   prometheus          running             0.0.0.0:9090->9090/tcp
   local-tempo-1        "/tempo -config.file…"   tempo               running             0.0.0.0:3200->3200/tcp, 0.0.0.0:4317-4318->4317-4318/tcp, 0.0.0.0:9411->9411/tcp, 0.0.0.0:14268->14268/tcp
   ```
5. As part of the docker compose manifest, Grafana is now reachable on port 3000. Open a browser to localhost:3000 and sign in to Grafana.
6. Once logged in, navigate to the **Explore** page, select the **Tempo** data source and select the **Search** tab. Select **Run query** to list the recent traces stored in Tempo. Select one to view the trace diagram:
   
   ![Query example](../../setup/assets/setup-linux-run-query.png)
7. A couple of minutes after Tempo has successfully restarted, select the **Service graph** tab for the Tempo data source in the **Explore** page. Select **Run query** to view a service graph, generated by Tempo’s metrics-generator.
   
   ![Service graph sample](../../setup/assets/setup-linux-node-graph.png)
8. To stop the services:

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
docker-compose down -v
```