If you want a Prometheus-compatible metrics store that runs on almost any small server, a VictoriaMetrics single-node binary install is the fastest way to get there. VictoriaMetrics is a fast, open-source time series database that stores metrics and works as a Prometheus-compatible alternative for monitoring.
This guide walks through the full VictoriaMetrics single-node binary process.
A lot of teams choose Thanos, Cortex, or a full Prometheus cluster before they even need one. A VictoriaMetrics single-node binary install gives you the same Prometheus query language and remote write support, but it runs as one small program with no extra moving parts.
Because there is only one process to manage, this setup uses far less RAM and disk space than Prometheus, Thanos, or Cortex for the same amount of data. That means you can run real production metrics on a cheap VPS instead of a large cluster.
For most small and mid-size setups, a single VictoriaMetrics node can handle up to 100 million active time series and around 2 million samples per second, based on real usage numbers from the project itself.
To complete the VictoriaMetrics single-node binary install, you just need a Linux VPS or dedicated server with a public or private IP, root or sudo access, and a little free disk space for stored metrics.
VictoriaMetrics ships as one small executable file, so there is nothing else to install first. Run these commands on your server to get the latest release:
If your server uses ARM, grab the arm64 build from the same releases page instead.
Check that the binary is there and can run:
It is good practice not to run this as root long-term. Create a system user and a storage folder before the first real run:
Start the binary with a data folder and a retention period so you can confirm it actually works:
Keep it running. Open a browser and navigate to:
If the query page loads, your VictoriaMetrics single-node binary install is live and ready for data.
You can also confirm it from another terminal:
It should return OK, confirming your install is healthy and accepting requests.
To stop the test, press Ctrl+C.
Note: If you use ufw, allow the port so Grafana and remote clients can reach it:
For production use, restrict this rule to trusted IPs only rather than opening it to everyone, since a VictoriaMetrics single-node binary install has no built-in authentication by default.
At this point, you can create a service file so it starts on boot and restarts on crash:
Add this content to the file:
Save the file, then load and start it:
Once this service is running, your install survives reboots without you touching it again.
The -retentionPeriod flag decides how long old data stays before it is deleted, and it defaults to one month if you skip it. Common values look like -retentionPeriod=12 for twelve months, or -retentionPeriod=30d for thirty days, and you set this once at startup.
To change it later, edit the ExecStart line in the service file and reload:
A shorter retention period uses less disk space. If your VPS has a small drive, start with short retention and increase it later as needed.
VictoriaMetrics can pull metrics the same way Prometheus does, using a -promscrape.config flag pointed at a normal prometheus.yml file.
You can easily create a simple scrape config file:
Add:
Then add the flag to your service file's ExecStart line:
Restart the service to apply it:
This scrape-based setup is the easiest path after a VictoriaMetrics single-node binary install, since you can reuse existing Prometheus configs with almost no changes.
The other option is remote write, where Prometheus or vmagent pushes data into VictoriaMetrics instead of pulling it.
Add this to an existing Prometheus config on another server:
This fits setups where Prometheus already exists on each server, and you only want VictoriaMetrics as cheap long-term storage, a common reason people choose a single-node install.
VictoriaMetrics answers the same query API as Prometheus, so Grafana treats it as a normal Prometheus data source. In Grafana, go to Connections, add a new data source, pick Prometheus as the type, and set the URL:
Click Save & Test.
Existing Prometheus dashboards usually work without edits right after a VictoriaMetrics single-node binary install, since the query language (MetricsQL) stays compatible with PromQL.
VictoriaMetrics can create an instant snapshot of all stored data by calling one HTTP endpoint, without stopping the service:
List existing snapshots:
Copy a snapshot off the server with a simple rsync or tar job, for safekeeping:
Doing this regularly protects the data in your install in case the disk fails or you need to move to a bigger server later.
Note: For a more advanced setup, VictoriaMetrics also has a tool called vmbackup. Instead of copying snapshot files manually, it can send them straight to cloud storage like S3, GCS, or Azure Blob Storage. This makes backups easier to manage once you outgrow storing them just on the local disk.
A rough size estimate helps you know if a small VPS is enough or if you need something bigger.
As a starting point, plan for about 1 to 2 KB of disk space per active time series each day. For RAM, expect about 2 to 4 GB for every one million active time series, though actual usage can vary depending on how many labels each series has.
If your data or retention grows too big for a small VPS, you can move to a dedicated server with a fast local disk instead. This keeps your queries fast without needing to switch to a bigger, more complex metrics stack.
A VictoriaMetrics single-node binary install gives most teams everything Prometheus offers, plus longer retention and lower cost, without extra cluster parts. Start on a cheap Linux VPS, watch your disk and RAM usage, and only scale up once real numbers tell you it is needed.
We hope you enjoy this guide. For more detailed information, check the official VictoriaMetrics Single-node version Docs.
Yes, the single-node version is licensed under Apache 2.0, so it's fully open source and free.
Yes, in most cases, it works as a drop-in replacement for scraping, storage, and Grafana queries.
Yes, VictoriaMetrics accepts standard Prometheus remote write. Tools like Prometheus, Grafana Alloy, or vmagent can push straight to it without any extra config.