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/module.py), 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.