---
title: "Deploy Postgres Observer"
description: "Monitor Railway and an existing PostgreSQL database in one dashboard."
category: "Observability"
url: https://railway.com/deploy/postgres-observer
---

# Deploy Postgres Observer

Monitor Railway and an existing PostgreSQL database in one dashboard.

**[Deploy Postgres Observer on Railway](https://railway.com/template/postgres-observer)**

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

- **Creator:** Pagetree's Projects
- **Category:** Observability

## Template content

### Postgres Observer

- **Source:** https://github.com/pagetree/railway-postgresql-dashboard-template

## Documentation

# Deploy and Host Postgres Observer on Railway

A deployable Railway dashboard for infrastructure and PostgreSQL telemetry.

## About Hosting Postgres Observer

Railway data includes services, environments, deployment IDs, deployment status, rollback availability, CPU use and limits, memory use and limits, network transfer, persistent disk, ephemeral disk, backup storage, regions, and deployment grouping.

PostgreSQL data includes database size, connection use, cache hit ratio, commits, rollbacks, deadlocks, temporary data, row activity, locks, table sizes, indexes, scans, dead rows, vacuum history, analyze history, and statement performance when `pg_stat_statements` is available.

## Why Deploy Postgres Observer on Railway?

Postgres Observer combines Railway infrastructure metrics and PostgreSQL statistics in one private dashboard. Deploy the Observer into a project that already has PostgreSQL, then connect the database URL after deploy.

## Common Use Cases

Monitor CPU, memory, network, disk, backups, deployments, database connections, cache efficiency, table growth, locks, vacuum activity, indexes, and query performance.

## Dependencies for Postgres Observer Hosting

### Deployment Dependencies

The template deploys only the Observer service. It expects an existing PostgreSQL service in the same Railway project.

## Railway Template Configuration

The deployer provides one value at deploy time:

1. `RAILWAY_PROJECT_TOKEN`

   What it is: A project scoped token that lets Observer read CPU, RAM, network, storage, service, and deployment metrics from Railway.

   Where to find it: Open the Railway project, select Project Settings, select Tokens, create a token for the environment being observed, then paste its value here.

After deploy, open the Observer service Variables and set `DATABASE_URL` to a reference of your existing PostgreSQL service, for example `${{Postgres.DATABASE_URL}}`.

The template generates `DASHBOARD_PASSWORD` automatically as a secret. Deployers do not enter a database URL, project IDs, environment IDs, or a dashboard password during deploy.

The dashboard sends Railway credentials only from the server. Tokens and database credentials are never returned to the browser.

## Local setup

Copy `.env.example` to `.env.local`, add the required values, install dependencies, then use the standard Next.js development command.

## PostgreSQL permissions

The dashboard performs read only statistics queries. Standard PostgreSQL statistics are available to the connected role. Statement analytics require `pg_stat_statements` to already be enabled and visible to that role. This project does not install extensions or modify the database schema.

## Health check

Railway checks `/api/health`. This endpoint reports process availability and does not expose credentials or telemetry.


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [VPS Fleet Watch Hub with Beszel](https://railway.com/deploy/vps-fleet-watch-hub-with-beszel) — A persistent Beszel hub for external VPS agents and fleet alerts.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.

Open this page in a browser: https://railway.com/deploy/postgres-observer