
Deploy Laminar
Trace, evaluate and query AI agents: full stack with ClickHouse and a login
Frontend
Just deployed
Just deployed
/var/lib/postgresql/data
RabbitMQ
Just deployed
/var/lib/rabbitmq
Quickwit
Just deployed
/quickwit/qwdata
Redis
Just deployed
/data
ClickHouse
Just deployed
/var/lib/clickhouse
App Server
Just deployed
Just deployed
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.
Template Content
Frontend
aalfath/laminar-railway-templateRabbitMQ
aalfath/laminar-railway-templateQuickwit
aalfath/laminar-railway-templateRedis
redis:8.2ClickHouse
aalfath/laminar-railway-templateApp Server
aalfath/laminar-railway-template
