This document is for a development version of Ceph.

Hello World Module

This is a simple module skeleton for documentation purposes.


The hello module is enabled with:

ceph mgr module enable hello

To check that it is enabled, run:

ceph mgr module ls

After editing the module file (found in src/pybind/mgr/hello/, you can see changes by running:

ceph mgr module disable hello
ceph mgr module enable hello


init-ceph restart mgr

To execute the module, run:

ceph hello

The log is found at:



After adding a new mgr module, be sure to add its documentation to doc/mgr/module_name.rst. Also, add a link to your new module into doc/mgr/index.rst.

Brought to you by the Ceph Foundation

The Ceph Documentation is a community resource funded and hosted by the non-profit Ceph Foundation. If you would like to support this and our other efforts, please consider joining now.