CEPH-IMMUTABLE-OBJECT-CACHE(8)

💖 CEPH-IMMUTABLE-OBJECT-CACHE 💖

okay bestie, so this is a page from the Ceph manual — section 8 — and it's all about ceph-immutable-object-cache, the daemon. let's get into it 🫶

---

✨ NAME ✨

ceph-immutable-object-cache — a Ceph daemon whose whole personality is being the immutable object cache 💅

---

🌸 SYNOPSIS 🌸

ceph-immutable-object-cache

that's it. that's the whole invocation. iconic minimalism honestly 👑

---

🦋 DESCRIPTION 🦋

so ceph-immutable-object-cache is a daemon that does object caching of RADOS objects across Ceph clusters. what it does is: whenever a promote request comes in, it promotes those objects to a local directory, and from then on, future reads get serviced straight out of those cached objects. no cap — the cache is the moment and the moment is the cache ✨

it connects to local clusters via the RADOS protocol, and it relies on the default search paths to find everything it needs — the ceph.conf files, the monitor addresses, and the authentication info. meaning it peeks at:

• /etc/ceph/$cluster.conf
• /etc/ceph/$cluster.keyring
• /etc/ceph/$cluster.$name.keyring

where $cluster is the human-friendly name of the cluster, and $name is the rados user to connect as — like, for example, client.ceph-immutable-object-cache. she knows exactly who she is and where she lives 💖

---

🎀 OPTIONS 🎀

• -c ceph.conf, --conf=ceph.conf — use the ceph.conf config file instead of the default /etc/ceph/ceph.conf to figure out the monitor addresses during startup.
• -m monaddress[:port] — connect to the specified monitor instead of going looking through ceph.conf.
• -i ID, --id ID — set the ID portion of the name for ceph-immutable-object-cache.
• -n TYPE.ID, --name TYPE.ID — set the rados user name for the gateway (eg. client.ceph-immutable-object-cache).
• --cluster NAME — set the cluster name (default: ceph).
• -d — run in foreground, log to stderr.
• -f — run in foreground, log to usual location.

---

🌈 AVAILABILITY 🌈

ceph-immutable-object-cache is part of Ceph, a massively scalable, open-source, distributed storage system. literally the whole vibe. if you want more, the Ceph documentation lives at <https://docs.ceph.com> and it's giving very much "read me" energy 📚✨

---

👑 SEE ALSO 👑

rbd <>(8)

---

💜 COPYRIGHT 💜

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0). so like, share alike bestie, that's the rule 🤝

---

aaaand that's a wrap, bb 🎀 this cutie was documented under the dev manual source, versioned Oct 06, 2026, in the Ceph 8 manual section. mwah 💋 slay, read responsibly 🌟