How do I deploy litemetrics on Railway?

You can deploy litemetrics 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: litemetrics-670e1bd7, or click "Get template help" for this template for more assistance.

Deploy and Host Litemetrics on Railway

Litemetrics is an open-source, self-hosted web analytics platform. It provides a lightweight browser tracker (~3.5KB), a real-time dashboard, and a multi-tenant query API. Privacy-friendly, cookie-free, and powered by ClickHouse for fast analytical queries.

About Hosting Litemetrics

Deploying Litemetrics requires two services: a ClickHouse database for storing analytics events and the Litemetrics server that handles event collection, query APIs, and serves the built-in dashboard UI. The Railway template provisions both services automatically with internal networking pre-configured. You only need to set an ADMIN_SECRET environment variable to secure site management. Once deployed, you get a single URL that serves the dashboard, the tracker script, and all API endpoints. Add a one-line script tag to any website to start collecting pageviews, custom events, and user sessions.

Common Use Cases

Website analytics without third-party services — Track pageviews, referrers, devices, countries, and custom events while keeping all data on your own infrastructure
Multi-tenant SaaS analytics — Embed per-customer analytics dashboards using the client SDK and query API, each site isolated by site ID
Product event tracking — Collect custom events, identify users, and analyze retention and engagement with the built-in React, React Native, and Node.js SDKs

Dependencies for Litemetrics Hosting

ClickHouse — Columnar database used for storing and querying analytics events
Litemetrics Server — Node.js application built from Dockerfile (serves dashboard, API, and tracker script)

Deployment Dependencies

ClickHouse — Default analytics database
Litemetrics GitHub Repository — Source code and documentation
Litemetrics npm packages — Browser tracker and SDK packages

Why Deploy Litemetrics on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Litemetrics on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.