---
title: "Deploy Laminar"
description: "Trace, evaluate and query AI agents: full stack with ClickHouse and a login"
category: "Observability"
url: https://railway.com/deploy/laminar-1
---

# Deploy Laminar

Trace, evaluate and query AI agents: full stack with ClickHouse and a login

**[Deploy Laminar on Railway](https://railway.com/template/laminar-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/laminar-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Observability

## Template content

### Frontend https://raw.githubusercontent.com/lmnr-ai/lmnr/v0.3.4/frontend/public/brand/logo-square.png

- **Source:** https://github.com/aalfath/laminar-railway-template
- **Health check:** /api/auth/ok

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### RabbitMQ https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/rabbitmq.svg

- **Source:** https://github.com/aalfath/laminar-railway-template
- **Health check:** /metrics

### Quickwit https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/quickwit.png

- **Source:** https://github.com/aalfath/laminar-railway-template
- **Health check:** /health/livez

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### ClickHouse https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/clickhouse.png

- **Source:** https://github.com/aalfath/laminar-railway-template
- **Health check:** /ping

### App Server https://raw.githubusercontent.com/lmnr-ai/lmnr/v0.3.4/frontend/public/brand/logo-square.png

- **Source:** https://github.com/aalfath/laminar-railway-template
- **Health check:** /health

### Laminar https://raw.githubusercontent.com/lmnr-ai/lmnr/v0.3.4/frontend/public/brand/logo-square.png

- **Source:** https://github.com/aalfath/laminar-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host Laminar on Railway

Laminar is an open-source observability and evaluation platform for AI agents and LLM apps. It records every LLM call, tool call and agent step as an OpenTelemetry trace, lets you search and query them with SQL, run evaluations on datasets, and label data, all from one dashboard you host yourself.

## About Hosting Laminar

Laminar's full self-hosted stack has eight parts: a Next.js dashboard, a Rust app server for ingestion and processing, PostgreSQL for accounts and projects, ClickHouse for spans and analytics, Quickwit for full-text search, RabbitMQ for the span queue, Redis for cache and realtime updates, and a gateway. This template deploys all of them on Railway's private network, pinned to Laminar v0.3.4, with every stateful service on its own volume and every password generated. The dashboard runs the database migrations on boot. Self-hosted Laminar has no passwords of its own, so the gateway puts the dashboard behind a login, while SDK ingestion stays open to project API keys.

## Common Use Cases

* Trace AI agents and LLM apps (OpenAI, Anthropic, LangChain, Vercel AI SDK and more) and debug each step
* Run evaluations on datasets and compare prompt or model changes over time
* Query traces, costs and latency with SQL and build dashboards, with your data on your own infrastructure

## Dependencies for Laminar Hosting

* Laminar frontend and app server v0.3.4 (official images, pinned by digest)
* ClickHouse 26.5, Quickwit 0.9.1, RabbitMQ 4.2, Railway PostgreSQL and Railway Redis, plus Caddy as the gateway

### Deployment Dependencies

* Laminar: https://laminar.sh and its self-hosting docs: https://laminar.sh/docs/self-hosting/overview
* Laminar releases: https://github.com/lmnr-ai/lmnr/releases
* Template source (Dockerfiles, changelog, smoke test): https://github.com/aalfath/laminar-railway-template

### Implementation Details

Services (only **Laminar** is public):

* **Laminar**: Caddy gateway on the public domain. `/v1/*` (SDK and OpenTelemetry ingestion, checked against project API keys) goes to the App Server; the dashboard needs the gateway login.
* **Frontend**: the dashboard. Runs Postgres and ClickHouse migrations and creates the Quickwit indexes on boot.
* **App Server**: trace ingestion, queue workers and realtime updates.
* **ClickHouse**: spans, traces and evaluations, with a separate read-only user for the SQL editor. Volume at `/var/lib/clickhouse`.
* **Quickwit**: full-text search over spans. Volume at `/quickwit/qwdata`.
* **RabbitMQ**: queues spans between ingestion and processing. Volume at `/var/lib/rabbitmq`.
* **Postgres** and **Redis**: Railway's own databases, each with a volume.

After deploy: wait until every service is green (first boot takes a few minutes), open the Laminar URL and log in as `admin` with `LAMINAR_PASSWORD` from the Laminar service's Variables. Enter your email, create a workspace and project, then create a project API key. Point the SDK at `https://YOUR-DOMAIN` with `http_port=443` and `force_http=True` (Railway serves HTTPS only, not public gRPC), or send OTLP/HTTP to `https://YOUR-DOMAIN/v1/traces` with `Authorization: Bearer YOUR-API-KEY`.

Optional: set `LLM_PROVIDER` and `LLM_API_KEY` on Frontend and App Server for the AI features, or OAuth keys (`AUTH_GITHUB_ID`, `AUTH_GITHUB_SECRET` and others) on Frontend.

Updates: every service except Postgres and Redis builds from the template's GitHub repo, with images pinned by version and digest. When a new Laminar release is tested and merged, Railway shows you an "update available" notice. Read the repo's CHANGELOG, then apply it. Migrations run on their own.

## Why Deploy Laminar 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 Laminar 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.



## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

Open this page in a browser: https://railway.com/deploy/laminar-1
