Tianji

What is Tianji about?

Tianji combines website analytics, uptime monitoring, and server‑status dashboards into one lightweight, self‑hosted solution. It targets users who need comprehensive insight without deploying multiple specialized tools.

How to use Tianji?

1. One‑click deployment – use the provided buttons for Sealos, Render, RepoCloud, or ClawCloud.
2. Docker – run the official image:

   docker run -d \
     -p 3000:3000 \
     --name tianji \
     moonrailgun/tianji
   

3. Helm – add the public Helm repository and install:

   helm repo add tianji https://charts.tianji.moonrailgun.com
   helm install my-tianji tianji/tianji
   

4. Source – clone the repo, install dependencies with pnpm, and start the server:

   git clone https://github.com/msgbyte/tianji.git
   cd tianji
   pnpm install
   pnpm run dev
   

   The application will be reachable at http://localhost:3000.

Key Features of Tianji

• Website analytics – page views, unique visitors, traffic sources, similar to Google Analytics or Umami.
• Uptime monitor – passive result reception, configurable checks, alert notifications.
• Server status – real‑time health metrics, Prometheus‑style reporting.
• Telemetry – simple collection of deployment statistics.
• OpenAPI – programmatic access to data.
• Team collaboration – shared dashboards and permissions.
• Lighthouse reports, hooks, waitlist, survey support.
• UTM tracking (planned), helm install, Docker image, multi‑language UI.

Use Cases

• Small SaaS or personal website owners who need basic traffic stats and uptime alerts without paying for GA or dedicated monitoring services.
• Developers deploying internal tools and wanting a telemetry endpoint to understand adoption.
• Teams requiring a unified dashboard for analytics, health checks, and incident notifications.
• Organizations that prefer self‑hosted solutions for data privacy and customization.

FAQ

Q: Is Tianji a SaaS service? A: No, it is fully self‑hosted; you run it on your own server or cloud instance.

Q: What databases does it require? A: The project uses SQLite by default and can be configured for PostgreSQL/MySQL in the production setup.

Q: Can I integrate existing monitoring tools? A: Yes, Tianji supports passive result reception and provides webhooks for external systems.

Q: How are alerts delivered? A: Built‑in notification channels include email, Slack, and custom webhook endpoints.

Q: Is there a free tier? A: Since it is self‑hosted, there is no usage‑based pricing; you only pay for the infrastructure you run.

Tianji

All-in-One Insight Hub

Website analytics + Uptime Monitor + Server Status = Tianji

All in one project!

Motivation

During our observations of the website. We often need to use multiple applications together. For example, we need analysis tools such as GA/umami to check pv/uv and the number of visits to each page, we need an uptime monitor to check the network quality and connectivity of the server, and we need to use prometheus to obtain the status reported by the server to check the quality of the server. In addition, if we develop an application that allows open source deployment, we often need a telemetry system to help us collect the simplest information about other people's deployment situations.

I think these tools should serve the same purpose, so is there an application that can integrate these common needs in a lightweight way? After all, most of the time we don't need very professional and in-depth functions. But in order to achieve comprehensive monitoring, I need to install so many services.

It's good to specialize in one thing, if we are experts in related abilities we need such specialized tools. But for most users who only have lightweight needs, an All-in-One application will be more convenient and easier to use.

Roadmap

• website analysis
• monitor
  • support passive reception of results
• server status
• problem notification
• telemetry
• openapi
• website
• team collaboration
• utm track
• waitlist
• survey
  • survey page
• lighthouse report
• hooks
• helm install support
  • allow install from public
• improve monitor reporter usage
  • uninstall guide
  • download from server
  • custom params guide

Preview

Translation

Add a new translation

modify those file:

• src/client/i18next-toolkit.config.cjs in this file, edit country code
• src/client/utils/i18n.ts in this file, add for display

Then, run below code to auto generate

cd src/client
pnpm install
pnpm run translation:extract
pnpm run translation:translate # this will call chatgpt to run auto translation, so you need set env `OPENAPI_KEY` to make sure run correct

Then manual check translation file in src/client/public/locales

Improve translation

Direct update src/client/public/locales

Open Source

Tianji is open source with Apache 2.0 license.

And its inspired by umami license which under MIT and uptime-kuma which under MIT license too

One-Click Deployment