How do I deploy Gauge on Railway?

You can deploy Gauge on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: gauge-b4ddd6ac, or click "Get template help" for this template for more assistance.

Deploy and Host Gauge on Railway

A complete metrics and analytics stack for Railway Template creators. featuring automated data collection, PostgreSQL persistence, and pre-configured Grafana dashboards to track revenue, health, and growth.

About Hosting Gauge

Hosting Gauge involves deploying a three-tier observability stack specifically designed for Railway template businesses:

a Bun-powered ingest service that interacts with the Railway GraphQL API and runs via a CRON service.
a PostgreSQL database for historical snapshot storage
a provisioned Grafana instance for professional-grade visualization.

The system automatically handles time-series growth calculations (24h, 7d, 30d) and provides deep insights into template retention and revenue momentum outside of Railway's current metrics.

Common Use Cases

Revenue Performance Tracking: Monitor lifetime and 30-day earnings across your entire template portfolio.
Template Health Monitoring: Keep track of health scores to ensure you maintain maximum payout percentages (25%).
Retention Analysis: Compare active projects against total deployments to calculate real-world retention rates.
Growth Rate Benchmarking: Identify high-momentum templates using 24-hour, 7-day, and 30-day revenue growth trends.
Portfolio Risk Management: Visualize revenue concentration to understand which templates drive your business.

Dependencies for Gauge Hosting

None! everything runs on Railway.

Deployment Dependencies

Railway API Token: Required to fetch metrics from your account; should be an account level token.
Railway Workspace IDs: For the workspace containing your templates. You can get this by hitting ctrl+k on the dashboard and typing Copy Active Workspace ID
Grafana Documentation: For advanced dashboard customization.
Railway GraphQL API: The source of truth for all ingested data.

Implementation Details

Quick Start Guide

Deploying Services

Click "Deploy on Railway" and provide your Railway API credentials, and Workspace ID in the environment variables.
Set your desired Grafana admin username.
Wait 2-3 minutes for the services to initialize.

Note on Initial Data: Since the ingest service is configured as a cron job, your dashboards won't display any metrics data until the first scheduled collection runs. This is expected behavior for scheduled workers on Railway. If you need immediate visibility, you can manually trigger the ingest service from the Railway dashboard. Future improvements may include an automatic initial run on deployment.

Access your dashboards via Grafana

Grab the automatically generated domain from the Grafana service.
Grab your generated password from the Grafna Service -> Variables -> GF_SECURITY_ADMIN_PASSWORD and copy it.
Access your Executive Summary dashboard via the generated domain and username/password.
OPTIONAL: add a custom domain to your Grafana service so it's easier to remember.

Environment Variables

Ingest Service (Bun)

These variables control the collection and processing of Railway API data.

Variable	Description	Default
`RAILWAY_API_TOKEN`	Your Railway personal API token	Required
`RAILWAY_WORKSPACE_ID`	Your Railway Workspace UUID	Required
`DATABASE_URL`	PostgreSQL connection string	Provided by Railway

Grafana (Visualization)

These variables configure the Grafana instance and its connection to the database.

Variable	Description	Default
`VERSION`	Grafana version to deploy (from `grafana/dockerfile`)	`latest` default
`GF_SECURITY_ADMIN_USER`	Grafana admin username	`admin`
`DATABASE_HOST`	Database internal hostname	`${{Postgres.RAILWAY_INTERNAL_HOST}}`
`DATABASE_PORT`	Database internal port	`${{Postgres.PORT}}`
`DATABASE_USER`	Database username	`${{Postgres.POSTGRES_USER}}`
`DATABASE_PASSWORD`	Database password	`${{Postgres.POSTGRES_PASSWORD}}`
`DATABASE_NAME`	Database name	`${{Postgres.POSTGRES_DB}}`

Version Control

Each service is pinned to stable versions for production reliability:

Bun (Ingest): latest (Alpine)
PostgreSQL: Railway's latest supported version (16+)
Grafana: 12.3.1 (Configurable via VERSION environment variable)

Connecting Applications

For Ingest: The ingest service runs as a scheduled worker (Cron) within the stack. It is pre-configured to connect to the internal PostgreSQL instance using the DATABASE_URL.

For Visualization: Grafana is auto-provisioned with a datasource named psql-gauge pointing to the internal database. No manual setup is required to see your metrics.

For Data Export: You can connect external BI tools to the PostgreSQL instance as needed- that data is yours even if you don't want to use Grafana to visualize it.

Customizing Your Stack

To customize dashboards or collection logic:

Fork the GitHub repository.
Modify the ingest logic in ingest/index.ts
Update dashboard JSON templates in grafana/dashboards/templates/ to add custom visualizations.
Commit, relink the repo, and push; Railway will automatically redeploy the updated services.

Why Deploy Gauge on Railway?

Railway is the premier platform for hosting infrastructure. By deploying Gauge on Railway, you get a self-healing, vertically-scaling observability stack that monitors your Railway business from within Railway.

Leverage the same platform that hosts your templates to analyze their success, ensuring minimal latency and maximum security for your business data.