[PATCH docs v2 2/3] pveceph: add section about ceph configuration

Alwin Antreich alwin at antreich.com
Wed Oct 29 10:18:10 CET 2025


to illustrate how to change the configuration in the MON DB.

Signed-off-by: Alwin Antreich <alwin at antreich.com>
---
 pveceph.adoc | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/pveceph.adoc b/pveceph.adoc
index 1ed6666..cefecad 100644
--- a/pveceph.adoc
+++ b/pveceph.adoc
@@ -567,6 +567,36 @@ The CLI command to destroy the OSD is:
 pveceph osd destroy <id> [--cleanup]
 ----
 
+[[pve_ceph_configuration]]
+Ceph Configuration
+------------------
+
+Ceph daemon and clients pull their configuration from one or more sources
+footnote:[Ceph config sources https://docs.ceph.com/en/latest/rados/configuration/ceph-conf/#config-sources].
+In {PVE}, a minimal ceph.conf file is used to hold bootstrap settings. Most of
+the configuration is held in the central configuration database maintained by
+the MON services.
+
+To persistently change configuration values use the bellow commands
+footnote:[Ceph MON DB commands https://docs.ceph.com/en/latest/rados/configuration/ceph-conf/#commands]:
+
+[frame="none",grid="none", align="left", cols="30%,70%"]
+|===
+|ceph config dump|Show all configuration option(s)
+|ceph config get <who> <name>|Show configuration option(s) for an entity
+|ceph config set <who> <name> <value>|Set a configuration option for one or more entities
+|ceph config rm <who> <name>| Clear a configuration option for one or more entities
+|===
+
+.Example for increasing the osd_memory_target for all OSD daemons
+[source,bash]
+----
+ceph config set osd osd_memory_target 8G
+----
+
+NOTE: If an option exists in a local configuration file, the configuration in
+the MON DB will be ignored because it has a lower precedence.
+
 
 [[pve_ceph_pools]]
 Ceph Pools
-- 
2.39.5





More information about the pve-devel mailing list