victoria-metrics

Overview

VictoriaMetrics is a fast, cost-effective and scalable monitoring solution and time series database. TLDR: It is a faster, more lightweight replacement to InfluxDB/TimescaleDB/etc (up to 20x faster data digestion, up to 7-10x less ram usage). Can be used in place of InfluxDB in many apps such as HomeAssistant. Includes a great web UI for query exploration. For HomeAssistant: drop in replacement for InfluxDB, see https://community.home-assistant.io/t/influxdb-vs-victoriametrics/453361 Git repository: https://github.com/VictoriaMetrics/VictoriaMetrics Dockerhub: https://hub.docker.com/r/victoriametrics/victoria-metrics Website: https://victoriametrics.com VictoriaMetrics prominent features: - Long-term storage for Prometheus. - Drop-in replacement for Prometheus and Graphite in Grafana. - Easy setup and operation with a single executable and configuration via command-line flags. - Fast backups with vmbackup/vmrestore tools. - Implements MetricsQL query language. - Global query view for multiple data sources. - High performance and scalability, outperforming InfluxDB and TimescaleDB by up to 20x. - Efficient RAM usage, 10x less than InfluxDB and up to 7x less than others. - Optimized for high-churn time series data. - High data compression, storing up to 70x more data points in limited storage. - Ideal for high-latency IO and low IOPS storage. - Can substitute moderately sized clusters of competing solutions. - Protects data from corruption on unclean shutdown. - Supports various metrics protocols, including Prometheus, InfluxDB, Graphite, OpenTSDB, and more. - Offers stream aggregation, metrics relabeling, and series limiting. - Suitable for diverse data sources like APM, Kubernetes, IoT, financial data, and more. - Open source cluster version. - Compatible with NFS-based storages like Amazon EFS and Google Filestore.

Requirements

Notes
===
VictoriaMetrics is very powerful with lots of configurations available, definitely go through the docs: https://docs.victoriametrics.com to get comfortable.

VMAgent may be needed depending on your use case.

For integrating into HomeAssistant: https://community.home-assistant.io/t/influxdb-vs-victoriametrics/453361 (you only need the influxdb: configurations shared throughout the thread)

Runtime arguments

Web UI: http://[IP]:[PORT:8428]/vmui
Network: bridge
Shell: bash
Privileged: false

Template configuration

DataPathrw

Data directory, includes config and the actual DB

Target: /victoria-metrics-data
Default: /mnt/user/appdata/victoria-metrics
Value: /mnt/user/appdata/victoria-metrics

PortPorttcp

Target: 8428
Default: 8428
Value: 8428

Retention PeriodVariable

Data with timestamps outside the retentionPeriod is automatically deleted. The minimum retentionPeriod is 24h or 1d.vThe following optional suffixes are supported: h (hour), d (day), w (week), y (year). If suffix isn't set, then the duration is counted in months (default 1m).

Target: retentionPeriod
Default: 99y
Value: 99y

Prometheus Scrape FileVariable

Location of promscrape config in the container. For example: /victoria-metrics-data/prometheus.yml. Disabled if nothing is set.

Target: promscrape_config

Prometheus Scrape Strictly ParseVariable

Set true to only parse valid promscrape configs. Incompatible fields: remote_write => -remoteWrite* remote_read => not supported rule_files and alerting => these sections are supported by vmalert.

Target: promscrape_config_strictParse
Default: false
Value: false

Links

Template Support Docker Hub Project

Details

Repository

victoriametrics/victoria-metrics:v1.118.0

Registry

https://hub.docker.com/r/victoriametrics/victoria-metrics

Last Updated2026-05-25

First Seen2025-05-28

Run victoria-metrics on Unraid.

victoria-metrics is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS