dockette/cadvisor repository overview

⁠Dockette / cAdvisor

Minimal Docker image for cAdvisor⁠ (Container Advisor), mirroring ghcr.io/google/cadvisor under the dockette/cadvisor name on Docker Hub.

🕹 f3l1x.io⁠ | 💻 f3l1x⁠ | 🐦 @xf3l1x⁠

cAdvisor⁠ (Container Advisor) collects and exposes resource usage and performance data for running containers. This image is a thin republish of ghcr.io/google/cadvisor as dockette/cadvisor on Docker Hub. See the upstream README⁠ and running docs⁠ for details.

⁠Features

• cAdvisor 0.60.6, FROM ghcr.io/google/cadvisor:${CADVISOR_VERSION}, so runtime behavior matches that upstream tag
• UI and API listen on port 8080 inside the container
• Only the modern GHCR tags are republished. Before cAdvisor v0.53.0 the registry was gcr.io/cadvisor/cadvisor

⁠Usage

# Docker on Linux host monitoring, as in the upstream quick start
docker run -d --name cadvisor --privileged --device=/dev/kmsg \
  --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 \
  dockette/cadvisor:0.60.6

# Open the UI
open http://localhost:8080

⁠Configuration

On rootless Docker, Podman or a non-default graph root, the path to the container runtime state may differ from /var/lib/docker. Change the bind mount to match your setup.

--privileged and --device=/dev/kmsg match the common upstream example for broad compatibility. You may be able to reduce privileges for your environment, see the upstream runtime options⁠.

⁠Versions

Image tags use the numeric form of the upstream version (0.60.6). Upstream GitHub releases⁠ use a v prefix (v0.60.6). All versions build on ghcr.io/google/cadvisor:0.60.6, pinned in VERSION and in the Dockerfile. Releases are listed on GitHub⁠ and tags on Docker Hub⁠.

⁠Development

make build     # build the image
make run       # run cAdvisor with the host mounts, --privileged and /dev/kmsg
make test      # start the image and check /healthz
make version   # print VERSION
make release   # set today's date in VERSION

⁠Maintenance

See how to contribute⁠ to this package. Consider to support⁠ f3l1x. Thank you for using this package.