selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

victoriametrics logo

Self-host victoriametrics

v1.156.0

Prometheus-compatible TSDB for metrics and alerting

ReleaseOpen CoreApache-2.0
Updated6 days ago
LanguageGo
Setup difficultyModerate
Stars
18 113
Port
8428 (HTTP server for querying, ingestion, vmui and metrics endpoints)
Docker
victoriametrics/victoria-metrics
Install with Docker
vmui query page with graph of metrics queried in MetricsQL

What is victoriametrics?

victoriametrics alternatives

All self-hosted alternatives to Graphite → All self-hosted alternatives to Thanos → All self-hosted alternatives to InfluxDB →

Should you self-host victoriametrics?

victoriametrics scores 78/100 on selfhost.directory (how scoring works) and ranks #3 of 5 in Time Series. It has 18 113 GitHub stars, +266 in the last 30 days.

It shipped 26 stable releases in the past year. The latest, v1.156.0, came out on 9 November 2026. New versions land roughly every 7 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is TimescaleDB (77/100, 23 861 stars). victoriametrics scores higher overall. See victoriametrics vs TimescaleDB side by side.

Features

  • Alerting via vmalertvmalert is a separate component of the VictoriaMetrics ecosystem.
  • Built-in web UI (vmui)
  • Cardinality limiter
  • Deduplication of scraped samples
  • Global query view
  • Instant snapshots and backup/restore
  • MetricsQL query language
  • Metrics relabeling
  • Multi-protocol metrics ingestion
  • No external dependencies / single binary
  • Prometheus-compatible storage and querying API
  • Prometheus exporter scraping
  • Retention with automatic data deletion
  • Stream Aggregation

victoriametrics README

VictoriaMetrics

Latest Release Docker Pulls Build Status License Join Slack X Reddit

VictoriaMetrics logo

VictoriaMetrics is a fast, cost-effective, and scalable solution for monitoring and managing time series data. It delivers high performance and reliability, making it an ideal choice for businesses of all sizes.

Here are some resources and information about VictoriaMetrics:

How to install victoriametrics

Install victoriametrics with Docker

docker pull victoriametrics/victoria-metrics:v1.154.0 docker run -it --rm -v `pwd`/victoria-metrics-data:/victoria-metrics-data -p 8428:8428 \ victoriametrics/victoria-metrics:v1.154.0 --selfScrapeInterval=5s -storageDataPath=victoria-metrics-data

Images published on Docker Hub and mirrored on Quay.

How to configure victoriametrics

  • -storageDataPathvictoria-metrics-dataDirectory where VictoriaMetrics stores all its data; default is victoria-metrics-data in the current working directory.

    values: path to a directory

  • -retentionPeriod1 month (31 days)Retention for stored data; older data is deleted automatically. Minimum is 24h or 1d.

    values: duration values such as 24h, 1d, months or years

  • -selfScrapeIntervalInterval at which VictoriaMetrics scrapes its own /metrics page; must be greater than 0.

    values: duration, e.g. 10s

  • -httpListenAddrTCP addresses to listen for incoming HTTP requests; can also be a unix:/path/to/socket.

    values: list of TCP addresses or unix socket paths

  • -promscrape.configOptional path to a Prometheus config file with scrape_configs targets to scrape; supports %{ENV_VAR} placeholders.

    values: local path, http or https URL

victoriametrics releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How does VictoriaMetrics handle backfilling of old (historical) metrics?

There is no limitation on backfilling historical or out-of-order samples as long as they fall inside the configured retention period.

Is it safe to enable remote write in Prometheus?

Yes, Prometheus keeps writing to its local storage after remote write is enabled; using vmagent for scraping is recommended.

What is the difference between vmagent and Prometheus?

vmagent usually needs less CPU, RAM and disk IO for very large target counts, keeps independent disk-backed buffers per remote storage and supports many ingestion protocols.

Can I use VictoriaMetrics instead of Prometheus?

Yes, in most cases: scraping/service discovery, alerting and recording rules via vmalert, and Prometheus-compatible querying in Grafana.

What are scalability limits of VictoriaMetrics?

The single-node version scales vertically and can handle about 100 million active time series and 2 million samples per second; the cluster version scales horizontally to billions of active time series.

Does VictoriaMetrics support replication?

Yes, the cluster version documents replication and data safety.

Does VictoriaMetrics support high availability?

Yes, high availability is documented for both single-node and cluster setups.

How to contribute to VictoriaMetrics?

See the Contributing guide in the documentation.

How to start using VictoriaMetrics?

Follow the Quick Start guide.

How does Victoriametrics work?

The FAQ lists technical articles explaining the internals of components such as vmagent, vmstorage, vminsert and vmselect.

Are there performance comparisons with other solutions?

Yes, the docs link to a collection of benchmark articles.

Which features does VictoriaMetrics have?

See the Prominent Features section of the single-node documentation for the full list.

Who uses VictoriaMetrics?

The FAQ points readers to the published case studies and articles.

What is the main purpose of VictoriaMetrics?

The project states its purpose is to be the best tool for monitoring and observability.

More in Time Series

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…