Tianji

Website analytics + uptime monitor + server status, in one dashboard. Not only another Google Analytics alternative — Tianji gives you real-time visitor tracking, uptime monitoring, and server health metrics in a single self-hosted platform.

Two services: Tianji (web app) + PostgreSQL (database).

Deploy and Host

Host your own Tianji on Railway. This template provisions the all-in-one Tianji container (website analytics, uptime monitoring, server status reporting) and a PostgreSQL companion for persistence. All data persists in a Railway volume at /var/lib/postgresql/data.

About Hosting

Tianji is a self-hosted analytics and monitoring platform. This template deploys it on Railway with a PostgreSQL companion database. All data persists in a Railway volume at /var/lib/postgresql/data. The app runs on port 8080 and is accessible via your Railway domain.

Why Deploy

Tianji is the open-source analytics platform that combines three essential tools into one:

Website Analytics — privacy-friendly alternative to Google Analytics with real-time visitor tracking, page views, and session analytics
Uptime Monitoring — monitor your websites and services with instant downtime alerts
Server Status — track CPU, memory, disk, and network metrics from your infrastructure

Running it on Railway gives you a durable, auto-updating, globally reachable instance with:

Full data ownership — your analytics data lives on your Railway volume, not a third-party server
Real-time dashboards — see visitor activity and server health as it happens
Alerting — get notified when services go down or metrics cross thresholds
Reporter agents — lightweight agents that collect and report metrics from your infrastructure
No ad stack — plain self-hosted software, your analytics

Common Use Cases

Privacy-conscious site owners who want analytics without Google tracking
DevOps teams who need unified uptime + server monitoring
Indie hackers who want a single dashboard for all their projects
Agencies who manage multiple client sites and need consolidated reporting

Dependencies for Tianji

Deployment Dependencies

The deploy form pre-fills all companion variables (DB host / name / user / password are wired to the PostgreSQL service via private-domain references — nothing to type).

After the first successful deploy:

Open your Railway public domain — the Tianji dashboard
Create your first workspace and website to start tracking
Add the tracking script to your website's head section
(Optional) Deploy the Tianji reporter agent to your servers for infrastructure monitoring

Environment Variables

Variable	Description	Default
`DATABASE_URL`	Full PostgreSQL connection string (auto-composed from PG* vars)	(empty)
`JWT_SECRET`	Random string for JWT signing (auto-generated)	(auto)
`ALLOW_REGISTER`	Allow new user registration	`false`
`ALLOW_OPENAPI`	Expose OpenAPI documentation	`true`
`PUBLIC_URL`	Public URL of this instance	(auto-filled)
`WEBSITE_ID`	UUID for self-tracking this instance	(empty)
`CLICKHOUSE_URL`	ClickHouse connection URL (optional)	(empty)

Service Architecture

tianji — Main web application (analytics, uptime, server status)
postgres — PostgreSQL 15 database companion

Volumes

/var/lib/postgresql/data — PostgreSQL data directory (persistent)

Health Checks

Tianji: GET /health on port 8080
PostgreSQL: Built-in pg_isready check

License

Tianji is open-source under the Apache License 2.0. This template is provided as-is for Railway deployment.