Skip to content
Projects

crazy-max/docker-rrdcached

View on GitHub

crazy-max/docker-rrdcached has 30 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 19:50 UTC. Last push 2026-11-14.

How these counts are measured

What you can do

  • Run as non-root user
  • Multi-platform image

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

RRDcached Docker image

Developer Tools

README.md

Original

Latest Version Build Status Docker Stars Docker Pulls
Become a sponsor Donate Paypal

About

RRDcached Docker image.

[!TIP] Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!


Features

  • Run as non-root user
  • Multi-platform image

Build locally

git clone https://github.com/crazy-max/docker-rrdcached.git
cd docker-rrdcached

# Build image and output to docker (default)
docker buildx bake

# Build multi-platform image
docker buildx bake image-all

Image

Registry Image
Docker Hub crazymax/rrdcached
GitHub Container Registry ghcr.io/crazy-max/rrdcached

Following platforms for this image are available:

$ docker buildx imagetools inspect crazymax/rrdcached --format "{{json .Manifest}}" | \
  jq -r '.manifests[] | select(.platform.os != null and .platform.os != "unknown") | .platform | "\(.os)/\(.architecture)\(if .variant then "/" + .variant else "" end)"'

linux/386
linux/amd64
linux/arm/v6
linux/arm/v7
linux/arm64
linux/ppc64le
linux/riscv64
linux/s390x

Environment variables

  • TZ : Timezone assigned to the container (default UTC)
  • PUID : Daemon user id (default 1000)
  • PGID : Daemon group id (default 1000)
  • LOG_LEVEL : Log level, called with -V (default LOG_INFO)
  • WRITE_TIMEOUT : Data is written to disk every X seconds, called with -w (default 300)
  • WRITE_JITTER : Delay writing of each RRD for a random number of seconds in the range, called with -z
  • WRITE_THREADS : Number of threads used for writing RRD files, called with -t (default 4)
  • FLUSH_DEAD_DATA_INTERVAL : Every X seconds the entire cache is searched for old values which are written to disk, called with -f (default 3600)

[!NOTE] More info : https://github.com/oetiker/rrdtool-1.x/blob/master/doc/rrdcached.pod

Volumes

  • /data/db : Contains rrd database
  • /data/journal : Container rrd journal files

[!WARNING] Note that the volumes should be owned by the user/group with the specified PUID and PGID. If you don't give the volume correct permissions, the container may not start.

Ports

  • 42217 : RRDcached port

Usage

Docker Compose

Docker compose is the recommended way to run this image. You can use the following compose template, then run the container:

docker compose up -d
docker compose logs -f

Command line

You can also use the following minimal command:

$ docker run -d -p 42217:42217 --name rrdcached \
  -e TZ="Europe/Paris" \
  -v $(pwd)/data/db:/data/db \
  -v $(pwd)/data/journal:/data/journal \
  crazymax/rrdcached

Upgrade

Recreate the container whenever I push an update:

docker compose pull
docker compose up -d

Contributing

Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub or by making a PayPal donation to ensure this journey continues indefinitely!

Thanks again for your support, it is much appreciated! :pray:

License

MIT. See LICENSE for more details.