---
title: "Deploy SigOnly"
description: "Deploy SigNoz with a working demo app & config in one click"
category: "Observability"
url: https://railway.com/deploy/sigonly
---

# Deploy SigOnly

Deploy SigNoz with a working demo app & config in one click

**[Deploy SigOnly on Railway](https://railway.com/template/sigonly)**

- **Creator:** zoeyjones's Projects
- **Category:** Observability
- **Total deploys:** 22

## Template content

### clickhouse https://avatars.githubusercontent.com/u/54801242?s=200&v=4

- **Source:** https://github.com/ZoeyJones/signoz-railway-template
- **Health check:** /ping

### signoz-otel-collector https://signoz.io/img/SigNozLogo-orange.svg

- **Source:** https://github.com/ZoeyJones/signoz-railway-template
- **Start command:** `/signoz-otel-collector --config=/etc/otel-collector-config.yaml --manager-config=/etc/manager-config.yaml --copy-path=/var/tmp/collector-config.yaml`

### signoz-sync-schema-migrator https://signoz.io/img/SigNozLogo-orange.svg

- **Image:** signoz/signoz-schema-migrator:v0.144.3-rc.1
- **Start command:** `/bin/sh -c "sleep 120 && exec ./signoz-schema-migrator sync --dsn=tcp://clickhouse.railway.internal:9000 --up="`

### signoz-demo https://raw.githubusercontent.com/ZoeyJones/SigNozDemo/refs/heads/main/sig_only.svg

- **Source:** ZoeyJones/SigNozDemo
- **Public domain:** Yes

### signoz-async-schema-migrator https://signoz.io/img/SigNozLogo-orange.svg

- **Image:** signoz/signoz-schema-migrator:v0.144.3-rc.1
- **Start command:** `./signoz-schema-migrator async --dsn=tcp://clickhouse.railway.internal:9000 --up=`

### zookeeper https://avatars.githubusercontent.com/u/47359?s=200&v=4

- **Image:** signoz/zookeeper:3.9.3
- **Health check:** /commands/ruok

### signoz https://signoz.io/img/SigNozLogo-orange.svg

- **Source:** https://github.com/ZoeyJones/signoz-railway-template
- **Start command:** `./signoz server`
- **Health check:** /api/v1/health
- **Public domain:** Yes

## Documentation

> **Fork note** — This is a fork of [SigNoz/signoz-railway-template](https://github.com/SigNoz/signoz-railway-template) with targeted fixes to make the Railway template work out of the box:
> - Pin Docker images to specific versions instead of `:latest`
> - Add missing `server` subcommand to SigNoz entrypoint
> - Remove stale `--feature-gates` flag that crashes the otel-collector
> - Set JWT secret, fix deprecated env vars, and correct migrator DSN syntax
>
> See [WHY.md](https://github.com/ZoeyJones/signoz-railway-template/blob/main/WHY.md) for full details and manual post-deploy steps.
>
> **Working demo** — [SigNozDemo](https://github.com/ZoeyJones/SigNozDemo) is a bare-minimum Spring Boot 4 + Kotlin app that validates this template end-to-end. Deploy it alongside SigNoz on Railway and you'll see traces, metrics, and logs flowing within minutes — proof that the template works as advertised.

# Deploy and Host SigNoz on Railway

**[SigNoz](https://signoz.io)** is an open-source observability platform that enables you to collect, store, and analyze distributed application **traces, metrics, and logs** using the OpenTelemetry standard.

## About Hosting SigNoz

When you deploy SigNoz on Railway, the following core services are provisioned:
- SigNoz
- SigNoz Otel Collector
- ClickHouse
- Zookeeper

The Railway template automatically sets up these services with the necessary environment variables, health checks, and persistent storage. This allows you to quickly go from deployment to creating dashboards. Simply point your application's OpenTelemetry SDK or agent to the provided ingest URL, and SigNoz will immediately begin visualizing service dependencies, latency, and errors.

## Common Use Cases

- **Application Performance Monitoring**: Monitor metrics, logs, and traces across your entire Railway application stack.
- **Debugging and Troubleshooting**: Correlate logs, metrics, and traces to quickly identify and resolve issues.
- **Infrastructure Observability**: Monitor system health, resource usage, and service dependencies in real time.
- **Alerting and Incident Response**: Set up alerts based on metrics and log patterns for proactive incident management.

## Dependencies for SigNoz Hosting

- **Persistent Storage**: Use a Railway volume (or external block storage) for ClickHouse and SigNoz data.
- **Ingest Traffic**: Applications should export OpenTelemetry traces, metrics, or logs over HTTP or gRPC.

### Deployment Dependencies

- [SigNoz Documentation](https://signoz.io/docs/)
- [OpenTelemetry Specification](https://opentelemetry.io/docs/)
- [ClickHouse Server](https://clickhouse.com/docs/en/)

### Implementation Details

To run the SigNoz stack on Railway, ensure the following:

#### OpenTelemetry Ingestion
- You may need to configure **Domains / Proxy** settings in Railway for the `signoz-otel-collector` service, depending on your use case.
- Port **4317** is open for ingestion by default.

#### SigNoz UI
- A public domain is configured automatically in Railway to access the SigNoz dashboard.

#### Schema-Migration Order
ClickHouse migrations run in the dedicated **`signoz-schema-migrator`** job. As the Railway does not yet offer Docker-style `depends_on`, dependent services can occasionally start before migrations finish and fail on their first boot.
If that happens, **redeploy these services after the migrator job completes**, in the exact order shown:

1. **signoz-async-schema-migrator**
2. **signoz** (main application)
3. **signoz-otel-collector**

After redeploying in this sequence, all components will connect to ClickHouse with the correct schema and operate normally.

## Why Deploy

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 SigNoz 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

- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [Unwrapped Spotify Music Stats](https://railway.com/deploy/wide-bold) — Unwrapped Spotify Music Stats, Estatísticas de músicas disponíveis
- [SigNoz | (Just Updated) Datadog Alternative, Admin Locked To You](https://railway.com/deploy/signoz-or-just-updated-datadog-alternati) — Traces, logs and metrics on ClickHouse. Admin seeded, ingest token-locked.

Open this page in a browser: https://railway.com/deploy/sigonly