HyperDX replaces proprietary APM platforms with open-source observability, unifying session replays, logs, and traces on ClickHouse and OpenTelemetry.
HyperDX pairs ClickHouse columnar storage with OpenTelemetry collectors to unify logs, distributed traces, metrics, and session replays under a single interface. Serving as the user interface of ClickStack after ClickHouse's acquisition of the project, it receives telemetry directly through standard network ports without proprietary agent software. By querying structured events in database tables, it provides sub-second diagnostics while keeping data on private infrastructure.
New Relic and Datadog APM rely on proprietary host agents, custom span formats, and metered ingestion fees that penalize high-volume logging. HyperDX replaces that vendor lock-in with an OpenTelemetry-native architecture. Services export traces, metrics, and logs over standard OTLP protocols directly to an ingestion collector, removing proprietary agents from production runtimes. Crucially, HyperDX correlates frontend session recordings with backend traces. When a browser exception occurs, developers inspect the recorded user session alongside the downstream database queries and service spans.
The trade-off involves third-party cloud integrations. New Relic supplies turn-key connectors for managed cloud services and global synthetic probes. HyperDX delegates collection to OpenTelemetry collectors, requiring DevOps engineers to configure scrapers and pipeline routing manually. Storing raw telemetry directly in ClickHouse gives teams schema control, eliminates SaaS egress fees, and enables direct SQL queries without exporting data to external warehouses.
Can HyperDX replace New Relic or Datadog APM? HyperDX replaces core distributed tracing, log search, metrics, and session replays through standard OpenTelemetry protocols. It lacks managed synthetic probes and turn-key cloud connectors, which teams configure independently.
Is HyperDX free for commercial use? Yes, the platform carries no licensing fees and permits commercial production deployment. Self-hosted teams only pay for the infrastructure required to run ClickHouse, MongoDB, and the collectors.
What infrastructure is required to self-host HyperDX? A self-hosted deployment runs on Docker or Kubernetes and requires the HyperDX web application, an OpenTelemetry Collector, ClickHouse for telemetry, and MongoDB for metadata.
HyperDX is a strong choice for engineering teams that need unified session replays, logs, and distributed traces without commercial SaaS costs, provided they can manage ClickHouse and MongoDB infrastructure. Active maintenance backed by ClickHouse and an MIT license that allows unrestricted internal deployment make it a reliable open-source alternative to proprietary monitoring suites.
We started this exact setup from scratch in a clean Linux machine on Nov 2, 2026 and checked it through HyperDX's own API: every check passed. Recipes are re-checked regularly and removed if they stop working.
mkdir -p hyperdx && cd hyperdx
curl -fsSL https://open-source.store/tools/hyperdx/compose.yml -o compose.ymlcat > .env <<EOF
HYPERDX_APP_URL=http://localhost:8080
EXPRESS_SESSION_SECRET=$(openssl rand -hex 16)
TOKEN_ENCRYPTION_KEY=$(openssl rand -hex 32)
EOFHYPERDX_APP_URL — Public base URL where clients and browsers access HyperDX. Set this to your server URL (e.g. http://<your-server>:8080 or https://hyperdx.example.com) before signing in.EXPRESS_SESSION_SECRET — Random secret key used to sign session cookies. Generated above; keep it secret.TOKEN_ENCRYPTION_KEY — 64-character hex key that encrypts stored integration and OAuth tokens. Generated above; keep it secret.docker compose up -dservices:
hyperdx:
image: hyperdx/hyperdx-all-in-one:2.43.1
ports:
- "8080:8080"
- "4317:4317"
- "4318:4318"
environment:
FRONTEND_URL: ${HYPERDX_APP_URL}
HYPERDX_APP_URL: ${HYPERDX_APP_URL}
EXPRESS_SESSION_SECRET: ${EXPRESS_SESSION_SECRET}
TOKEN_ENCRYPTION_KEY: ${TOKEN_ENCRYPTION_KEY}
USAGE_STATS_ENABLED: "false"
volumes:
- hyperdx-data:/data/db
- hyperdx-ch:/var/lib/clickhouse
restart: always
healthcheck:
test: ["CMD-SHELL", "curl -f http://localhost:8080/api/health"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
volumes:
hyperdx-data:
hyperdx-ch:
Free IDE for Java, Kotlin, Go, TypeScript and Python. Built on IntelliJ Community, fully open source, 300+ plugins.
Show that HyperDX is listed as an open-source alternative. Paste into your README:
Ubuntu 24.04 · Apple container, Docker 29.1.3, Compose 2.40.3+ds1-0ubuntu1~24.04.1. Images pulled in 65 s: hyperdx/hyperdx-all-in-one:2.43.1.
Based on the upstream setup. Official all-in-one image bundling ClickHouse, MongoDB, OTel Collector, API, and Next.js frontend with auth enabled.
hyperdx-1 | 2026-11-02T07:29:18.794761252Z hyperdx-1 | 2026-11-02T07:29:18.795171127Z Send OpenTelemetry data via: hyperdx-1 | 2026-11-02T07:29:18.795177210Z http/protobuf: OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 hyperdx-1 | 2026-11-02T07:29:18.795178210Z gRPC: OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317 hyperdx-1 | 2026-11-02T07:29:18.795178919Z hyperdx-1 | 2026-11-02T07:29:18.795191460Z Exporting data to ClickHouse: hyperdx-1 | 2026-11-02T07:29:18.795192502Z Endpoint: tcp://ch-server:9000?dial_timeout=10s hyperdx-1 | 2026-11-02T07:29:18.795193044Z Database: default hyperdx-1 | 2026-11-02T07:29:18.795193544Z hyperdx-1 | 2026-11-02T07:29:18.806031794Z Waiting for ClickHouse to be ready... hyperdx-1 | 2026-11-02T07:29:19.814103378Z ClickHouse is ready! hyperdx-1 | 2026-11-02T07:29:19.847089753Z hyperdx-1 | 2026-11-02T07:29:19.847103878Z Visit the HyperDX UI at http://localhost:8080 hyperdx-1 | 2026-11-02T07:29:19.847105003Z