---
title: "Deploy VictoriaLogs"
description: "VictoriaLogs 1.52 fast log database with LogsQL, Loki and OTLP ingestion."
category: "Observability"
url: https://railway.com/deploy/victorialogs-1
---

# Deploy VictoriaLogs

VictoriaLogs 1.52 fast log database with LogsQL, Loki and OTLP ingestion.

**[Deploy VictoriaLogs on Railway](https://railway.com/template/victorialogs-1)**

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

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

## Template content

### victorialogs https://raw.githubusercontent.com/VictoriaMetrics/VictoriaLogs/v1.52.0/app/vlselect/vmui/favicon.svg

- **Image:** victoriametrics/victoria-logs:v1.52.0
- **Start command:** `/victoria-logs-prod -storageDataPath=/vlogs -httpListenAddr=:9428 -enableTCP6 -retentionPeriod=%{VL_RETENTION} -retention.maxDiskSpaceUsageBytes=%{VL_MAX_DISK_SPACE} -httpAuth.username=%{VL_USERNAME} -httpAuth.password=%{VL_PASSWORD}`
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host VictoriaLogs on Railway

VictoriaLogs is a fast, resource-efficient open-source log database from the VictoriaMetrics team. It ingests logs through Elasticsearch, Loki, OpenTelemetry, syslog and JSON line APIs, stores them compactly with high-cardinality fields, and queries them with LogsQL from a built-in web UI, Grafana or the HTTP API.

## About Hosting VictoriaLogs

This template deploys VictoriaLogs v1.52.0 from the official image with its data on a Railway volume. Built-in HTTP basic authentication with a generated password protects ingestion, queries and the web UI, while `/health` stays open for Railway. Logs are kept for 14 days and total disk use is capped at 4 GiB, so the volume stays within the Hobby limit; raise both for more history. The server listens on IPv4 and IPv6, so shippers on Railway send logs over the private network. A single small service handles ingestion, storage, queries and the UI.

## Common Use Cases

- Central log storage for apps, workers and databases on Railway
- A lightweight replacement for Loki or Elasticsearch for logs
- Searching logs from Grafana with the VictoriaLogs data source

## Dependencies for VictoriaLogs Hosting

- `victoriametrics/victoria-logs:v1.52.0` (official image)
- A Railway volume at `/vlogs`

### Deployment Dependencies

- [VictoriaLogs documentation](https://docs.victoriametrics.com/victorialogs/)
- [VictoriaLogs v1.52.0 release](https://github.com/VictoriaMetrics/VictoriaLogs/releases/tag/v1.52.0)
- [Data ingestion](https://docs.victoriametrics.com/victorialogs/data-ingestion/)
- [Railway volumes](https://docs.railway.com/reference/volumes)

### Implementation Details

| Service | Image | Networking | Storage |
| --- | --- | --- | --- |
| victorialogs | `victoriametrics/victoria-logs:v1.52.0` | public domain on 9428; private IPv4/IPv6 | volume at `/vlogs` |

```bash
curl -u admin:$VL_PASSWORD -H 'Content-Type: application/stream+json' \
  -X POST "https:///insert/jsonline?_stream_fields=app" \
  --data-binary '{"_msg":"payment failed","level":"error","app":"api"}'
curl -u admin:$VL_PASSWORD https:///select/logsql/query --data-urlencode 'query=_time:1h level:error'
```

| Variable | Default | Purpose |
| --- | --- | --- |
| `VL_USERNAME` / `VL_PASSWORD` | `admin` / generated | Basic auth for all endpoints except `/health` |
| `VL_RETENTION` | `14d` | Retention period |
| `VL_MAX_DISK_SPACE` | `4GiB` | Oldest data is dropped above this size |

Notes:

- Send a `Content-Type` header with JSON line data, or the body is read as a form and nothing is stored.
- The OpenTelemetry endpoint accepts OTLP protobuf from exporters and collectors; the Loki push API also works.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the VictoriaLogs project or its maintainers.

## Why Deploy VictoriaLogs 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 VictoriaLogs 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/victorialogs-1