---
title: "Deploy Helicone"
description: "Open-source LLM observability: log cost, latency and prompts of AI calls"
category: "Observability"
url: https://railway.com/deploy/helicone
---

# Deploy Helicone

Open-source LLM observability: log cost, latency and prompts of AI calls

**[Deploy Helicone on Railway](https://railway.com/template/helicone)**

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

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

## Template content

### web https://raw.githubusercontent.com/Helicone/helicone/main/docs/favicon.png

- **Source:** https://github.com/aalfath/helicone-railway-template
- **Health check:** /api/hello

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

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

### helicone https://raw.githubusercontent.com/Helicone/helicone/main/docs/favicon.png

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

### jawn https://raw.githubusercontent.com/Helicone/helicone/main/docs/favicon.png

- **Source:** https://github.com/aalfath/helicone-railway-template
- **Health check:** /healthcheck

### migrations https://raw.githubusercontent.com/Helicone/helicone/main/docs/favicon.png

- **Source:** https://github.com/aalfath/helicone-railway-template

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

- **Source:** https://github.com/aalfath/helicone-railway-template
- **Health check:** /minio/health/live

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

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

## Documentation

# Deploy and Host Helicone on Railway

Helicone is an open-source LLM observability platform. Send your OpenAI or Anthropic calls through its proxy, or log them from your code, and it records every request with cost, latency, token counts and the full prompt and response, so you can debug, monitor spend and review quality in one dashboard.

## About Hosting Helicone

Self-hosted Helicone has several parts: a Next.js dashboard, the Jawn API server that also proxies LLM calls, Postgres for accounts and API keys, ClickHouse for request analytics, and S3-compatible storage for request and response bodies. The browser has to reach the dashboard, the API and the stored bodies on one origin, and the first account normally needs manual SQL because self-hosted Helicone sends no verification email. This template runs each part as its own Railway service on the private network, puts them behind one HTTPS domain, runs the database migrations on every deploy, creates your verified admin account, closes public sign-up and generates every secret.

## Common Use Cases

* Log every LLM call from your apps with cost, latency and token usage per user or feature
* Debug agents and multi-step chains with the full request and response bodies
* Track spend across OpenAI and Anthropic models in one dashboard
* Keep prompts and completions in your own infrastructure for privacy or compliance

## Dependencies for Helicone Hosting

* Helicone `web`, `jawn` and `migrations` images, release v2025.08.21
* PostgreSQL (Railway Postgres), ClickHouse 24.3, MinIO (S3 storage) and a Caddy router

### Deployment Dependencies

* Helicone repository: https://github.com/Helicone/helicone
* Helicone self-hosting guide: https://docs.helicone.ai/getting-started/self-host/docker
* Template source and changelog: https://github.com/aalfath/helicone-railway-template

### Implementation Details

| Service | Role | Storage |
|---|---|---|
| helicone | Public router: `/jawn/*` to the API, bucket paths to MinIO, the rest to the dashboard | – |
| web | Helicone dashboard | – |
| jawn | API server and LLM proxy | – |
| migrations | Runs Postgres and ClickHouse migrations on each deploy, creates the first admin, then exits | – |
| clickhouse | Request analytics | Volume |
| minio | Request and response bodies | Volume |
| Postgres | Accounts, organizations, API keys | Volume |

**First login**

1. Enter your email as `HELICONE_ADMIN_EMAIL` when you deploy. It is the only prompt.
2. Wait until the `migrations` logs end with `migrations and bootstrap finished`.
3. Open `https://YOUR-DOMAIN/signin` and sign in with that email and the generated `HELICONE_ADMIN_PASSWORD` from the `migrations` service's variables.
4. Create a Helicone API key under Settings, then point your client at the proxy:
   * OpenAI: base URL `https://YOUR-DOMAIN/jawn/v1/gateway/oai/v1`
   * Anthropic: base URL `https://YOUR-DOMAIN/jawn/v1/gateway/anthropic`
   * Add the header `Helicone-Auth: Bearer YOUR-HELICONE-KEY`. Your provider key stays in your app and is passed through.

**Teammates:** sign-up is closed. Set `HELICONE_ALLOW_SIGNUP=true` on the `helicone` service while teammates register, then remove it. New accounts need a verified email: add SMTP settings (`SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`) to `web`, which needs a Railway plan with outbound SMTP, or mark them verified in Postgres.

**Updates:** every service builds from the template repo, so Railway offers you an update when a new version is merged there. Read the changelog first. The `migrations` service applies schema changes on its next deploy.

**Resources:** about 700 MB of RAM in total when idle (measured in our test).

## Why Deploy Helicone 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 Helicone 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/helicone
