Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

replit/datacat

DevOps & Self-hosting

Self-hosted observability platform for metrics, logs, traces, dashboards and alerts using PostgreSQL or ClickHouse.

119
9
TypeScript
Apache-2.0
1 day old

What it does

DataCat is a self-hosted observability stack that brings metrics, logs, distributed traces, dashboards, infrastructure maps and alerting into one application. It stores its own data in PostgreSQL by default, or telemetry in ClickHouse if configured, and requires no hosted account or external service.

The platform includes a metrics explorer with formulas, searchable logs with facets, live tail and trace correlation, an APM service catalog with a trace explorer and waterfall view, and monitors that notify through webhooks or Slack. It also provides organizations, local email/password accounts, single-use invites and API keys, so a team can share one instance.

Data goes in through two paths: OpenTelemetry OTLP/HTTP endpoints and a Datadog-compatible intake. A single production process serves the API, web UI, installer and agent downloads.

Quick start

You need Docker Engine with the Compose plugin, Git and OpenSSL. From the repository root:

git clone https://github.com/replit/datacat
cd datacat
cp .env.example .env
sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$(openssl rand -hex 24)/" .env
sed -i "s/^SESSION_SECRET=.*/SESSION_SECRET=$(openssl rand -hex 32)/" .env
chmod 600 .env
mkdir -p downloads
docker compose up -d --build

Open http://localhost:3000, create the admin account and organization, then generate an API key under Organization Settings. Setup asks for a setup token, which is printed in the server log (docker compose logs datacat | grep "setup token") unless DATACAT_SETUP_TOKEN was set in advance. Before inviting colleagues or installing agents on other machines, set PUBLIC_URL to the externally reachable HTTPS origin.

Agent binaries and SDK packages are separate release assets; place them, including SHA256SUMS, in downloads/ so the instance can serve them. The self-hosting guide covers Ubuntu installation, backups, systemd and agent setup in more detail.

Sending data

Connect an OpenTelemetry Collector or SDK to /v1/traces, /v1/metrics and /v1/logs (also exposed under /otlp/v1/*), or point a Datadog Agent at the intake API. Datadog Agent 7.56.2 and 7.85.4 are listed as tested; releases between 7.57 and 7.84 were not tested individually, and unsupported trace formats return a 422 rather than a silent acceptance. GET /api/v1/intake/stats reports how many items each intake path stored or dropped since the server started.

Running from source

Source builds require Node.js 22.15+, pnpm 10.11.0 and PostgreSQL 14+. Node 20 is not supported by the current SDK.

corepack enable
corepack prepare pnpm@10.11.0 --activate
pnpm install --frozen-lockfile
BASE_PATH=/ pnpm run build:selfhost
NODE_ENV=production PORT=3000 pnpm start

Set DATABASE_URL, SESSION_SECRET and PUBLIC_URL in the environment first. The server migrates its schema automatically before listening, so there is no manual migration step or separate frontend server.

Constraints

DataCat is designed for self-hosting: you operate the server, database and HTTPS endpoint yourself. PostgreSQL is the default store; ClickHouse is an alternative for telemetry data and requires the configuration described in the self-hosting docs. Authentication is local email/password only, with access granted through single-use invite links. Remote agent installation and colleague invitations depend on PUBLIC_URL being set to a reachable HTTPS origin. The project is Apache-2.0 licensed and states it is independent of Datadog, Inc.

HotRepo's take

DataCat entered HotRepo's new-project list on 2026-11-18 with 11 stars gained over a roughly 1.5-hour measurement window and 8 forks; no GitHub daily rank has been recorded. The feature set is broad for such a young repository, so the presence of repeatable benchmarks with stored evidence and an end-to-end test path in bench is a more useful signal than the early star count. The Datadog-compatible intake is a practical migration route, but only two agent versions are named as tested.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. open-telemetry/opentelemetry-goAdd traces, metrics and logs to Go services and export them to any observability backend through one vendor-neutral API.Go6,581
  2. openobserve/openobserveA self-hosted observability backend that unifies logs, metrics, traces and frontend monitoring in one binary.TypeScript22,583
  3. ccfos/nightingaleSelf-hosted alerting engine that evaluates rules over existing metrics, logs, and SQL sources and routes notifications.Go13,438
  4. grafana/grafanaOpen-source platform for querying, visualizing and alerting on metrics, logs and traces from multiple data sources.TypeScript77,811
  5. open-telemetry/opentelemetry-collectorA vendor-neutral telemetry pipeline that replaces a stack of per-backend agents with one receive-process-export collector.Go7,704