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.

GitHub
cadvisor logo

Self-host cadvisor

v0.61.0

Container resource and performance monitoring daemon

ReleaseOpen SourceApache-2.0
Updated2 minutes ago
LanguageGo
Setup difficultyModerate
Stars
19 532
Port
8080 (HTTP listener serving the web UI, REST API and /metrics endpoint)
Docker
ghcr.io/google/cadvisor
Install with Docker

What is cadvisor?

cAdvisor (Container Advisor) watches the containers live on a host and tells you how they consume machine resources. For every container it retains isolation parameters plus a rolling history of usage and histograms, along with network statistics, and reports these per container and for the machine as a whole. Docker works out of the box, other container types are targeted too, and a Podman socket can be pointed at directly. Consumption is flexible: a browser UI on its listen port, a versioned remote REST API, a Prometheus scrape endpoint, and storage-driver export to InfluxDB, Elasticsearch, Kafka, Redis, StatsD, BigQuery or stdout. Self-hosting takes one privileged docker run command mounting rootfs, /var/run, /sys and the Docker data directory; alternatively run the dependency-free Go binary with sudo, or roll out the kustomize Kubernetes daemonset. Fine-tuning flags cover metric families to enable or disable, housekeeping intervals, history window, perf-event counter configs and which containers get reported. Not yet delivered, per its own roadmap, are performance advice, auto-tuning and usage prediction; today it gathers and publishes. The project is Apache-2.0 licensed and maintained under the google GitHub organisation, with stable releases.

cadvisor alternatives

Should you self-host cadvisor?

cadvisor scores 72/100 on selfhost.directory (how scoring works) and ranks #15 of 105 in Monitoring & observability. It has 19 532 GitHub stars, +55 in the last 30 days.

It shipped 16 stable releases in the past year. The latest, v0.61.0, came out on 16 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 prometheus (92/100, 67 650 stars). It scores higher overall, so compare the two before you pick. See cadvisor vs prometheus side by side.

Features

  • Configurable sampling intervals
  • Container label metadata on metrics
  • Go client library
  • Hardware perf event counters
  • Kubernetes daemonset deployment
  • Metric selection
  • Per-container resource usage monitoring
  • Prometheus metrics export
  • REST API
  • Standalone static binary
  • Storage backend export
  • Web UI
  • Web UI authenticationOnly the /containers endpoint is protected; /api and /metrics stay open.

cadvisor README

cAdvisor

test status

How to install cadvisor

Install cadvisor with Docker

VERSION=0.55.1 # use the latest release version from https://github.com/google/cadvisor/releases
sudo docker run \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:ro \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --volume=/dev/disk/:/dev/disk:ro \
  --publish=8080:8080 \
  --detach=true \
  --name=cadvisor \
  --privileged \
  --device=/dev/kmsg \
  ghcr.io/google/cadvisor:$VERSION # for versions prior to v0.53.0, use gcr.io/cadvisor/cadvisor instead

Directories with Docker state must be mounted so cAdvisor can observe them.

How to configure cadvisor

  • --store_container_labelstrueWhen false, container labels and env vars are not turned into Prometheus metric labels.

    values: true/false

  • --whitelisted_container_labelsComma-separated container labels to expose as Prometheus metric labels.
  • --env_metadata_whitelistEnvironment variable keys collected for containers (containerd and docker runtimes).
  • --docker_onlyfalseReport only container metrics, skipping raw cgroup data except the root cgroup.

    values: true/false

  • --disable_root_cgroup_statsfalseSkip collecting root cgroup statistics.

    values: true/false

cadvisor releases & version history

@ Every self-hosted release, weekly

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

More in Containers

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…