Deploy Laminar

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

Deploy Laminar

/var/lib/postgresql/data

/var/lib/rabbitmq

/quickwit/qwdata

Just deployed

/data

Just deployed

/var/lib/clickhouse

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

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

More templates in this category

View Template
Rootprint
Open-source logs and traces with full-text search on object-storage.

Rootprint
1
View Template
Pyroscope profiling
Protected continuous profiling with durable Pyroscope storage.

Anton Orel
1
View Template
SigOnly
Deploy SigNoz with a working demo app & config in one click

zoeyjones
21