---
title: "Deploy DataCat"
description: "Self-hosted metrics, logs and traces dashboard"
category: "Observability"
url: https://railway.com/deploy/deploy-datacat-observability
---

# Deploy DataCat

Self-hosted metrics, logs and traces dashboard

**[Deploy DataCat on Railway](https://railway.com/template/deploy-datacat-observability)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/deploy-datacat-observability/manifest.json

- **Creator:** onepush
- **Category:** Observability

## Template content

### postgres https://devicons.railway.app/postgres

- **Image:** postgres:16-alpine

### datacat https://api.iconify.design/mdi/chart-timeline-variant.svg

- **Image:** ghcr.io/onepush-dev/datacat:f08fb63
- **Health check:** /api/healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host self hosted DataCat (Observability) on Railway

This template deploys DataCat, an Apache-2.0 self-hosted observability dashboard for metrics, logs, traces, dashboards and monitors, as independent community packaging of replit/datacat at commit f08fb63 (Copyright 2026 The DataCat authors). It is not affiliated with or endorsed by Replit, DataCat, or Datadog. Telemetry is stored in a bundled Postgres service, and OTLP intake is available.

## About Hosting DataCat open-source software on Railway (self hosted DataCat template)

This template runs DataCat, the Apache-2.0 observability dashboard for metrics, logs, traces, dashboards and monitors, as two services: a datacat service built from upstream replit/datacat at commit f08fb63, and a bundled postgres:16-alpine service.

Railway provisions the containers, wires DATABASE_URL to the private Postgres address, generates the session secret and setup token, and handles HTTPS on the public domain.

## Why Deploy DataCat, the self-hosted observability dashboard on Railway

Self-hosting DataCat on Railway keeps your metrics, logs and traces in a Postgres database you control, instead of sending them to a hosted observability service that bills by volume.

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying DataCat on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

### Railway vs Other Hosting Providers and VPS for DataCat self hosting

Self-hosting DataCat means choosing where the app and its bundled Postgres run, and each option trades setup effort for control.

| Provider | What You Get with Railway | What You Get with the Other Provider |
| --- | --- | --- |
| DigitalOcean | Both services deployed from one template, with a public HTTPS domain. | A droplet you control, but Docker, firewall, HTTPS and upgrades are yours to manage. |
| AWS | A template with generated secrets and health checks already wired. | Broad service choice, but VPCs, storage and load balancing need setup first. |
| Hetzner | Managed datacat and postgres services with no server to maintain. | Low-cost servers, where you handle the OS, Docker, backups and security updates. |

Pick Railway for a quick working instance, and a VPS when you need full host control.

## Common Use Cases for hosted DataCat

- **Web UI for metrics and dashboards:** Point your team at the public domain on Railway to build metric charts, formulas and dashboards in one browser tab, without sending the data to a third-party hosted service.
- **Searchable logs with live tail:** Send application logs over OTLP to the /otlp/v1/logs path, then search and filter them in the UI when you need to debug a failing deploy.
- **Trace review for services:** Forward OpenTelemetry traces from your services to see the APM service catalog and step through a trace waterfall when a request is slow.
- **Monitors with notifications:** Create metric, log or trace monitors that fire webhook or Slack notifications when a threshold is crossed, so you know about a problem before a user reports it.
- **Telemetry kept in bundled Postgres:** Because spans, logs and metrics are stored in the postgres service on a Railway volume, you keep one database to back up and restore, and ClickHouse is not required.

## Dependencies for DataCat Docker hosted on Railway

The template deploys two services: datacat, the public web service on port 8080, and postgres, which holds all application data and telemetry on a private volume.

### Deployment Dependencies for Managed DataCat Service

The datacat service is public on port 8080, has no volume, checks /api/healthz with a 300 second timeout, and restarts Always. The postgres service restarts On Failure.

### Implementation Details for DataCat

The image ghcr.io/onepush-dev/datacat:f08fb63 is built from unmodified replit/datacat at commit f08fb63 and runs as USER node.

The template sets five variables with zero inputs.

## How does DataCat compare against other tools

### DataCat vs a hosted observability service (Hosted Observability Alternative)

- **Data location:** DataCat keeps metrics, logs and traces in the bundled Postgres service on your Railway project. A hosted service keeps that data on its own infrastructure.
- **Cost model:** DataCat is Apache-2.0 with no license fee, and you pay only for Railway usage. Hosted services often bill per host or event, which can be easier to predict at small scale.
- **Feature depth:** Mature hosted platforms offer a wider integration catalog and more enterprise features, so they still win for large teams.

### DataCat vs keeping logs only on your app host (Self-Managed Logs Alternative)

- **Central view:** Keeping logs on the app host means grepping files one server at a time. DataCat gives you one searchable place with trace correlation.
- **Operational load:** A file-based setup needs only log rotation. DataCat adds a Node process and a Postgres database to keep an eye on.
- **Retention:** DataCat keeps telemetry for 15 days by default, so plan disk space around that window.

### DataCat with Docker vs Railway (Railway Alternative for DataCat)

- **Control:** A self-run Docker Compose install gives you direct control of volumes, ports and TLS. Railway handles the domain, HTTPS proxy and restarts for you.
- **Setup effort:** Compose needs a `.env` file and a reverse proxy. Railway asks for no inputs and generates the session secret and setup token.
- **Persistence:** Only the Postgres service has a volume, and the agent downloads directory is empty. Keep one replica of each service, because local persistent state does not scale out.
## How to use DataCat on Railway?

1. Open the public domain Railway generated for the datacat service. The setup page appears.
2. Copy DATACAT_SETUP_TOKEN from the datacat Variables tab and paste it into the setup page. Create the admin account and organization.
3. Go to Organization Settings and create an API key.
4. Send OTLP/HTTP telemetry to your domain, for example logs to /otlp/v1/logs.
5. If you add a custom domain, update PUBLIC_URL to match it.
6. Keep one replica of each service, and confirm /api/healthz responds before sending data.

```
Public domain:   https://your-domain.up.railway.app
Setup token:     DATACAT_SETUP_TOKEN from Variables
OTLP logs:       https://your-domain/otlp/v1/logs
Health check:    /api/healthz
```

## How to self host DataCat on other VPS Services (DataCat self hosting guide)

### Clone the Repository

Clone the upstream repository at the pinned commit so your build matches the packaged image.

```sh
git clone https://github.com/replit/datacat
cd datacat
git checkout f08fb635fd7f28f6ed725209382af3e2c2673676
```

### Install Dependencies

Use Node.js 22.15 or newer, pnpm 10.11.0, and PostgreSQL 14 or newer.

```sh
corepack enable
corepack prepare pnpm@10.11.0 --activate
pnpm install --frozen-lockfile
```

### Configure Environment Variables

Set DATABASE_URL, SESSION_SECRET (at least 32 random characters), PUBLIC_URL such as https://your-domain, and DATACAT_SETUP_TOKEN for first-run setup.

```sh
export DATABASE_URL="postgresql://datacat_user:your-password@localhost:5432/datacat"
export SESSION_SECRET="$(openssl rand -hex 32)"
export PUBLIC_URL="https://your-domain"
export DATACAT_SETUP_TOKEN="$(openssl rand -hex 16)"
```

### Start the DataCat Application

Build and start the server, then open the public URL and paste the setup token to create the admin account.

```sh
BASE_PATH=/ pnpm run build:selfhost
NODE_ENV=production PORT=3000 pnpm start
```

## Pricing and License of DataCat (DataCat pricing)

DataCat is open-source software released under the Apache-2.0 license, so you can self-host it without paying a license fee.

## DataCat hosted vs self hosted comparison (Pricing, features, costs, and more)

This template packages the Apache-2.0 software, and the pinned commit does not describe a hosted DataCat plan.

### Monthly cost of self hosting DataCat on Railway

Railway bills by usage, so the monthly cost depends on the RAM, CPU and volume storage used by the datacat and postgres services, plus how much telemetry you send.

### System Requirements for Hosting DataCat on a VPS

A VPS needs enough memory and CPU for a Node.js process and a PostgreSQL database, plus disk that grows with telemetry over the 15-day retention window.


After each deploy, open the public domain and confirm the health check passes before you treat the service as ready. Keep one replica of any service that holds local persistent state, because a second replica would not see the same volume data. Copy the generated values from the Variables tab into your own records, and keep signing or encryption keys stable across redeploys. If you attach a custom domain, update the public URL variables to that origin before you rely on callbacks, invites, media links or sign-in. Optional mail, AI or agent features need credentials you supply later and are not required to boot this template. Upgrades, backups and restores stay your responsibility.

## Frequently Asked Questions (FAQs)

### How do I create the admin account?

Open your public domain and paste the DATACAT_SETUP_TOKEN value from the datacat Variables tab on the setup page.

### Where is telemetry stored?

Metrics, logs and traces are stored in the bundled Postgres service, which is the upstream default.

### Can I install the DataCat agent from the UI?

Not from this packaging, because agent binaries are not bundled and the downloads directory is not on a volume.

### What should I back up?

Back up the Postgres volume at /var/lib/postgresql, since that holds your telemetry and app data.

### Is DataCat affiliated with Datadog or Replit?

No.


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

Open this page in a browser: https://railway.com/deploy/deploy-datacat-observability
