1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
Tianji
Development512MB+ RAM
All-in-one insight hub — combines web analytics, uptime monitoring, and server telemetry into a single self-hosted dashboard
developmentdevtoolstianjiopen-sourceself-hosteddocker
Deploy Tianji in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select Tianji
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy Tianji on a VPS with Server Compass
Use the Tianji template in Server Compass to deploy a self-hosted insight hub for web analytics, uptime monitoring, and server telemetry on your VPS, then verify the first-run setup or dashboard in a browser.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for Tianji
Use the template picker search to find Tianji in the Server Compass template catalog.
4
Step 4Select the Tianji template
Choose the Tianji template. Server Compass fills the Tianji service, PostgreSQL database, generated database password, JWT secret, and public dashboard port.
5
Step 5Review the Tianji settings
Confirm the app name, generated database password, JWT secret, and compose services. In this run, the app was named tianji-demo and used host port 4242.
6
Step 6Deploy Tianji
Review the generated compose settings, confirm the Tianji web port is available, and click Deploy.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the Tianji image, starts the container, and verifies the stack.
8
Step 8Confirm Tianji is running
After deployment finishes, return to the Apps tab and confirm the Tianji app is marked Running with its application URL available.
9
Step 9Open Tianji in the browser
Open the application URL in a browser. The Tianji first-run setup, login page, or dashboard confirms the platform is reachable.
After Tianji Opens
- Complete the first-run admin setup and keep registration disabled unless you intentionally want public signups.
- Create a workspace, add a website, configure uptime monitors, or add the server telemetry reporter.
- Copy the analytics tracking snippet only after you have chosen the sites that should report into Tianji.
- Put Tianji behind HTTPS before collecting production analytics or uptime data.
- Back up the db_data volume because it stores users, workspaces, websites, events, and monitor history.
- Keep the Tianji image updated for dependency and security fixes.
Verified Result
The Tianji web interface loaded successfully from the deployed container.
Tianji deployment questions
What does the Tianji template deploy?
It deploys Tianji with a PostgreSQL database for analytics, uptime monitoring, server telemetry, users, and workspace configuration.
Which port did the tutorial use?
The tutorial used host port 4242, which maps to the same Tianji web UI port inside the container because the image listens on the generated PORT value.
Does Tianji need setup after deployment?
Yes. Open the web UI after deployment, complete the first-run admin setup, create a workspace, then add websites, monitors, or telemetry reporters.
Should this become a blog post?
No. The deployment guide should live on the Tianji template detail page and be linked from the reusable template deployment docs page.
After Deployment
After deploying Tianji with Server Compass, complete these steps to finish setup
1
Visit http://YOUR_SERVER_IP:{{PORT}} and complete the first-run admin setup
2
Create a workspace and add a website / server / monitor
3
Paste the analytics snippet into your site, or install the lightweight reporter for server metrics
4
(Optional) Enable ALLOW_REGISTER via Env Vars if you want a public sign-up form
Need help? Check out our documentation for detailed guides.
Tianji FAQ
Common questions about self-hosting Tianji
How do I deploy Tianji with Server Compass?
Simply download Server Compass, connect to your VPS, and select Tianji from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Tianji?
Tianji requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Tianji data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Tianji backup and restore procedures.
How do I update Tianji to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Tianji image will be pulled and deployed with zero downtime.
Is Tianji free to self-host?
Tianji is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Related Templates
View all Development
PocketBase
Open-source backend in a single file with realtime database, auth, and file storage
Appwrite
Open-source backend-as-a-service - self-hosted Firebase alternative
Parse Server
Open-source backend framework with dashboard
Supabase
Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio
Ready to Self-Host Tianji?
Download Server Compass and deploy Tianji to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass