Deploy Uptrace on your own server.

Uptrace is an open-source APM platform for traces, metrics, and logs using OpenTelemetry, with ClickHouse storage and PostgreSQL metadata. This template follows the official example/docker compose stack (Uptrace, ClickHouse, Postgres, Redis, OTel Collector, Vector, Grafana, Prometheus, Alertmanager, Mailpit). The Vector image uses…

Deploy Uptrace View source

Your infrastructureAutomatic HTTPSNo lock-in

Screenshots

A closer look at Uptrace.

Setup time

A few minutes

Deployment

Your own server

Services

10 connected services

Why Uptrace

Everything you need, running where you choose.

Get the full Uptrace experience with Easypanel handling the repetitive infrastructure work around it.

Distributed Tracing

Visualize request flows across services with service graphs, faceted filters, and SQL-like query language for span analysis.

Metrics & Dashboards

PromQL-like language for metrics aggregation with 50+ auto-created dashboards and chart annotations.

Alerting & Notifications

Monitor spans, logs, and metrics with alerts via Email, Slack, Telegram, WebHook, and AlertManager integration.

Grafana Compatible

Use Uptrace as a Tempo and Prometheus datasource in Grafana for seamless integration with existing dashboards.

Multi-Tenant Support

Manage multiple organizations and projects with SSO support via OpenID Connect (Keycloak, Google, Cloudflare).

High Performance

More than 10K spans/second on a single core with excellent on-disk compression for cost-effective long-term retention.

How it works

From template to live app in three steps.

Easypanel turns the template into real services, storage, and domains on the server you already control.

Already have Easypanel? Open your dashboard at the URL or IP of your own installation.

Installation guide

Open your dashboard

Visit the URL or IP of your Easypanel installation and choose the target project.

Choose Uptrace

Open Templates, select Uptrace, then review its service names and configuration.

Deploy and open your app

Easypanel starts every service and provisions an HTTPS domain for you.

Installation options

The template asks for these values before creating your services.

Option	Default	Required
App Service Name	uptrace	Required
Uptrace Image Pinned to the tag used in github.com/uptrace/uptrace example/docker docker-compose.yml; bump only with a tested exact tag.	uptrace/uptrace:2.1.0-beta.5	Required
Admin Name	Admin	Optional
Admin Email	[email protected]	Optional
Admin Password Generated randomly if not provided.	Set during install	Optional
Grafana admin password Grafana login user is admin. Leave empty for a random password (written to grafana.ini), or set explicitly.	Set during install	Optional
Organization Name	Org1	Optional
Project Name	Project1	Optional

Before you deploy

Login; Use the admin name/email/password from the template form (password is random if left blank). The project DSN token is generated once per deploy and embedded in `/etc/uptrace/config.yml`, OTel Collector, Grafana datasource, Prometheus remote_write, and Vector—keep file mounts stable or regenerate configs together. Ingestion; Published host ports match the upstream example—14317→4317 (Uptrace gRPC, referenced in `site.ingest_url`), 4317/4318 (OTLP on the collector). On shared hosts these can conflict; change published ports in Easypanel and update `ingest_url` / client endpoints accordingly. Grafana & Mailpit use separate app domains on ports 3000 and 8025; assign subdomains or paths in Easypanel as needed. TLS; Upstream compose mounts TLS certs; this template omits them for HTTPS termination at the proxy—see Uptrace docs if you need in-container TLS.

Resources

Project documentation and source code.