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.

prometheus logo

Self-host prometheus

v3.16.0

Open-source monitoring with dimensional time series database

ReleaseOpen SourceApache-2.0
Updatedlast week
LanguageGo
Setup difficultyModerate
Stars
67 629
Port
9090 (HTTP UI, API, and telemetry)
Docker
prom/prometheus
Install with Docker

What is prometheus?

Prometheus is a monitoring toolkit for systems and services, originally created at SoundCloud and now a graduated CNCF project. It gathers metrics from targets at set intervals using an HTTP pull approach, evaluates rule expressions, and fires alerts through the companion Alertmanager. Its standout features are a multi-dimensional data model with key-value labels, the PromQL query language for flexible analysis, standalone single-server operation with local storage, service discovery for automatic target detection, and hierarchical federation support. The server runs as a single binary with no external dependencies, deployable via precompiled binaries for Linux, macOS, and Windows, Docker images on Docker Hub and Quay, or built from source using Go and Node.js. The web interface defaults to port 9090. A large ecosystem of exporters extends Prometheus to monitor applications, databases, hardware, and cloud platforms.

prometheus alternatives

Should you self-host prometheus?

prometheus scores 92/100 on selfhost.directory (how scoring works) and ranks #1 of 105 in Monitoring & observability. It has 67 629 GitHub stars, +1 146 in the last 30 days.

It shipped 17 stable releases in the past year. The latest, v3.16.0, came out on 5 November 2026. New versions land roughly every 2 weeks.

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 grafana (90/100, 77 920 stars). prometheus scores higher overall. See prometheus vs grafana side by side.

Features

  • Agent mode
  • Alerting rules
  • Configuration reload
  • OTLP receiver
  • Recording rules
  • Remote read
  • Remote write

prometheus README

Prometheus
Prometheus

Visit prometheus.io for the full documentation, examples and guides.

CI Docker Repository on Quay Docker Pulls CII Best Practices govulncheck OpenSSF Scorecard CLOMonitor Fuzzing Status

Prometheus, a Cloud Native Computing Foundation project, is a systems and service monitoring system. It collects metrics from configured targets at given intervals, evaluates rule expressions, displays the results, and can trigger alerts when specified conditions are observed.

How to install prometheus

Install prometheus with Docker

docker run --name prometheus -d -p 127.0.0.1:9090:9090 prom/prometheus

Images available on Docker Hub (prom/prometheus) and Quay.io (quay.io/prometheus/prometheus)

How to configure prometheus

  • --config.fileprometheus.ymlPrometheus configuration file path
  • --web.listen-address0.0.0.0:9090Address to listen on for UI, API, and telemetry
  • --storage.tsdb.pathdata/Base path for metrics storage
  • --web.enable-lifecyclefalseEnable shutdown and reload via HTTP request

    values: true,false

  • --web.enable-admin-apifalseEnable API endpoints for admin control actions

    values: true,false

prometheus releases & version history

@ Every self-hosted release, weekly

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

FAQ

Can I reload Prometheus's configuration?

Yes, sending SIGHUP to the Prometheus process or an HTTP POST request to the /-/reload endpoint will reload and apply the configuration file.

Why do you pull rather than push?

Pulling over HTTP allows starting extra monitoring instances as needed, easily telling if a target is down, and manually inspecting target health with a web browser.

What dependencies does Prometheus have?

The main Prometheus server runs standalone as a single monolithic binary and has no external dependencies.

More in Metrics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…