victoriametrics/vmctl repository overview

⁠VictoriaMetrics vmctl

⁠What is vmctl?

vmctl (VictoriaMetrics Control) is a command-line tool for migrating data to and from VictoriaMetrics. It is essential for migrating data from other time series databases like InfluxDB or Prometheus, or for transferring data between two VictoriaMetrics instances.

⁠How to Use This Image

vmctl is typically run as a one-off Docker command to perform a specific migration task.

Common Scenarios:

• Migrate from Prometheus⁠:

docker run -it --rm victoriametrics/vmctl:latest prometheus
  --vm-addr=<vm-addr>:8428 \
  --prom-snapshot=/path/to/snapshot

• Migrate from InfluxDB v1⁠:

docker run -it --rm victoriametrics/vmctl:latest influx \
  -influx-addr="http://<influx-addr>:8086" \
  -influx-database="your_database" \
  -vm-addr="http://<vm-addr>:8428"

• Migrate from VictoriaMetrics⁠:

docker run -it --rm victoriametrics/vmctl:latest vm-native \
  -vm-native-src-addr="http://<prometheus-addr>:9090" \
  -vm-native-dst-addr="http://<vm-addr>:8428" \
  -vm-native-filter-time-start='2025-12-01T00:00:00Z' \
  -vm-native-filter-match='{__name__!~"vm_.*"}'

⁠Documentation

Read more about the available migration methods and configuration flags in VictoriaMetrics - vmctl⁠ documentation.

⁠Where to Get Help