---
title: "Deploy Quickwit search"
description: "Fast log and trace search with authenticated access and durable storage."
category: "Observability"
url: https://railway.com/deploy/quickwit-search
---

# Deploy Quickwit search

Fast log and trace search with authenticated access and durable storage.

**[Deploy Quickwit search on Railway](https://railway.com/template/quickwit-search)**

- **Creator:** Anton Orel's Projects
- **Category:** Observability
- **Total deploys:** 1

## Template content

### Quickwit Gateway

- **Image:** caddy:2.10-alpine@sha256:4c6e91c6ed0e2fa03efd5b44747b625fec79bc9cd06ac5235a779726618e530d
- **Start command:** `/bin/sh -ec 'password_hash="$(caddy hash-password --plaintext "$QUICKWIT_PASSWORD")"; printf '"'"':8080 {\n handle /healthz {\n  respond "ok" 200\n }\n handle {\n  basic_auth {\n   %s %s\n  }\n  reverse_proxy %s\n }\n}\n'"'"' "$QUICKWIT_USERNAME" "$password_hash" "$QUICKWIT_UPSTREAM" >/tmp/Caddyfile; exec caddy run --config /tmp/Caddyfile --adapter caddyfile'`
- **Health check:** /healthz
- **Public domain:** Yes

### Quickwit

- **Image:** quickwit/quickwit:0.9.0@sha256:1e6169bf4e98a489fca397105f1698c1d80a0f9779f3cf652973bac8a0c3b2bd
- **Start command:** `/usr/bin/bash -ec "sed -i 's/^#   split_store_max_num_bytes: 100G/  split_store_max_num_bytes: 1G/; s/^# ingest_api:/ingest_api:/; s/^#   max_queue_memory_usage: 2GiB/  max_queue_memory_usage: 512MiB/; s/^#   max_queue_disk_usage: 4GiB/  max_queue_disk_usage: 2GiB/' /quickwit/config/quickwit.yaml; exec quickwit run"`
- **Health check:** /health/readyz

### Quickwit PostgreSQL

- **Image:** postgres:17-alpine@sha256:742f40ea20b9ff2ff31db5458d127452988a2164df9e17441e191f3b72252193

## Buckets

- **Quickwit Indexes**

## Documentation

# Deploy and Host Quickwit on Railway

Deploy Quickwit behind an authenticated gateway with private PostgreSQL metadata, durable Railway Bucket index storage, and a persistent Ingest V2 WAL.

## About Hosting Quickwit

Quickwit is an Apache-2.0 search engine built for logs and traces. This template runs its search, indexing, control-plane, metastore, and janitor roles in one private service, while an authenticated gateway provides public UI and REST access.

## Why Deploy Quickwit on Railway

Railway supplies the private service network, PostgreSQL metadata store, S3-compatible Bucket, persistent WAL volume, generated credentials, and health-checked public gateway in one deployment. The result preserves Quickwit's durable storage model without exposing its unauthenticated listener.

## Common Use Cases

- Search application and infrastructure logs retained in object storage.
- Build a small-team observability or trace-search service.
- Evaluate Quickwit APIs and index mappings with durable metadata and splits.

## Dependencies for Quickwit Hosting

The template includes every required dependency and generates all credentials automatically.

### Deployment Dependencies

- Quickwit `0.9.0` for indexing and search.
- PostgreSQL `17` for metadata.
- A Railway Bucket for committed index splits.
- Caddy `2.10` for Basic Auth and public reverse proxying.
- Two 5 GB volumes for PostgreSQL and Quickwit's Ingest V2 WAL/local data.

After deployment, open `Quickwit Gateway` and use its generated `QUICKWIT_USERNAME` and `QUICKWIT_PASSWORD`. Only the gateway receives a public domain; the Quickwit API, PostgreSQL database, and object-storage credentials remain private.

The template is single-node and intended for evaluation and small-to-medium search or observability workloads. Back up PostgreSQL, the Railway Bucket, and the Quickwit volume together before upgrades.


## Similar templates

- [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
- [Unwrapped Spotify Music Stats](https://railway.com/deploy/wide-bold) — Unwrapped Spotify Music Stats, Estatísticas de músicas disponíveis

Open this page in a browser: https://railway.com/deploy/quickwit-search